Calimero0000: Criou nova página com '{{Notícia|As antigas ''collapsible tables'' que eram descritas nesta página tornaram-se obsoletas. As predefinições que ainda a utilizam devem ser migradas para o nov...'

2013-04-24T02:57:16Z

Criou nova página com '{{Notícia|As antigas ''collapsible tables'' que eram descritas nesta página tornaram-se obsoletas. As predefinições que ainda a utilizam devem ser migradas para o nov...'

Página nova

{{Notícia|As antigas ''collapsible tables'' que eram descritas nesta página tornaram-se obsoletas. As predefinições que ainda a utilizam devem ser migradas para o novo plugin [[mw:Manual:Collapsible elements#jQuery.makeCollapsible|jQuery.makeCollapsible]] disponível no [[mw:MediaWiki 1.18|MediaWiki 1.18]], no qual as classes recebem o prefixo '''<code>mw-</code>''' (como em <code>'''mw-'''collapsible</code>)}}

As tabelas expansíveis ou contraíveis (em inglês, ''Collapsible tables''), oferecem um meio de ocultar e mostrar informação numa tabela alternadamente através do botão esconder/expandir. O código para esta funcionalidade encontra-se está disponível por padrão no [[MediaWiki]] a partir da versão [[mw:MediaWiki 1.18|1.18]] na forma de um plugin [[jQuery]], e uma versão antiga ainda é mantida na página [[MediaWiki:Common.js]] até que todos as predefinições e páginas que a utilizam tenham sido migradas para o novo sistema.

O estado inicial de qualquer conteúdo expansível pode ser definido como "escondido" ou "expandido" adicionando ou não a classe <code>mw-collapsible</code> (antigamente, apenas <code>collapsible</code>). No estado escondido, a tabela mostra apenas o cabeçalho e um botão para expandi-la.

==Exemplo simples==
É mais fácil trabalhar com tabelas, uma vez que só é preciso incluir a classe '''<code>mw-collapsible</code>''' à tabela. Para que apareça o botão expandir/esconder, a primeira linha da tabela tem que conter um cabeçalho, ou seja uma das células da primeira linha tem que ser aberta com '''!''', ponto de exclamação. No exemplo abaixo, o uso da classe <tt>wikitable</tt> é apenas para definir a aparência da tabela; não é necessário à função que expande e oculta o conteúdo das tabelas.

{| class="wikitable" style="width:80%;"
!Código
!Resultado
|-
|style="width:50%;"| 
<nowiki>{| class="wikitable </nowiki>'''mw-collapsible'''"
'''!'''<nowiki> Tabela expansível simples
|-
| Lorem ipsum dolor sit amet
|}</nowiki>
|style="width:50%; text-align:center;"|
{| class="wikitable mw-collapsible"
! Tabela expansível simples
|-
| Lorem ipsum dolor sit amet
|}
|}

Normalmente usa-se a sintaxe acima, quando deseja-se mostrar somente a informação introdutória, ou o sumário de um texto longo, enquanto se esconde a maioria do conteúdo da vista. O sumário é colocado no cabeçalho, e o conteúdo no corpo da tabela. Para depois ver o conteúdo, basta um clique no botão "expandir". A função collapsible também pode ser usada em tabelas maiores e mais complicadas, desde que haja um cabeçalho na primeira linha dessa tabela.

{| class="wikitable" style="width:80%;"
!Código!!Resultado
|-
|style="width:50%; font-size:90%"| 
<nowiki>{| class="wikitable </nowiki>'''mw-collapsible'''<nowiki>"
|Célula normal na 1ª linha
</nowiki>'''!'''<nowiki> colspan="2"| Cabeçalho ocupando duas colunas
|-
| colspan="2" | Lorem ipsum dolor sit amet
| Célula normal
|}</nowiki>
|style="width:50%; text-align:center;"|
{| class="wikitable mw-collapsible"
|width=33%|Célula normal na 1ª linha
! colspan="2"| Cabeçalho ocupando duas colunas
|-
| colspan="2" | Lorem ipsum dolor sit amet
|width=33%| Célula normal
|}
|}

==Ocultar conteúdo por padrão==
A definir apenas a classe da tabela como <tt>mw-collapsible</tt>, a tabela aparece expandida por defeito, mas pode ser contraída pelo leitor. Mas também é possível criar tabelas que aparecem contraídas por defeito, e expandidas pelo leitor. Há varias maneiras de se fazer isto, cada uma dependendo do que se deseja.

==="mw-collapsed"===
Adicionar a classe <tt>'''mw-collapsed'''</tt> fará com que a tabela apareça ''sempre'' contraída, ou seja, com o conteúdo oculto, independentemente de outras definições. É também a maneira mais fácil para ocultar o conteúdo por defeito. Aplicando esta definição aos exemplos acima obtemos:

{| class=wikitable style="width:80%;" align=center
!Código!!Resultado
|-
|width=50%| 
<nowiki>{| class="wikitable </nowiki>'''mw-collapsible mw-collapsed'''"
'''!'''<nowiki> Tabela expansível simples
|-
| Lorem ipsum dolor sit amet
|}</nowiki>
|style="width:50%; text-align:center;"|
{| class="wikitable mw-collapsible mw-collapsed"
! Tabela expansível simples
|-
| Lorem ipsum dolor sit amet
|}
|-
|style="width:50%; font-size:90%"| 
<nowiki>{| class="wikitable </nowiki>'''mw-collapsible mw-collapsed'''<nowiki>"
|Célula normal na 1ª linha
</nowiki>'''!'''<nowiki> colspan="2"| Cabeçalho de duas colunas
|-
| colspan="2" | Lorem ipsum dolor sit amet
| Célula normal
|}</nowiki>
|style="width:50%; text-align:center;"|
{| class="wikitable mw-collapsible mw-collapsed"
|width=33%|Célula normal na 1ª linha
! colspan="2"| Cabeçalho de duas colunas
|-
| colspan="2" | Lorem ipsum dolor sit amet
|width=33%| Célula normal
|}
|}

==="autocollapse"===
:'''''Nota''': Esta opção ainda não está disponível no plugin do MediaWiki 1.18 ([[bugzilla:30352|bug #30352]]).''

Ao adicionar <tt>'''autocollapse'''</tt> à classe fará com que ela apareça contraída, se exister mais que um determinado número de collapsible tables na página. Aqui na Wikimotorpédia Lusófona, esse houver duas ou mais collapsible tables na página, então ambas aparacem contraídas. No examplo abaixo, a tabela aparece contraída, pois há várias tabelas deste genero nesta página.

{| class=wikitable style="width:80%;" align=center
!Código!!Resultado
|-
|width=50%| 
<nowiki>{| class="wikitable </nowiki>'''collapsible autocollapse'''"
'''!'''<nowiki> Tabela expansível simples
|-
| Lorem ipsum dolor sit amet
|}</nowiki>
|style="width:50%; text-align:center;"|
{| class="wikitable collapsible autocollapse"
! Tabela expansível simples
|-
| Lorem ipsum dolor sit amet
|}
|}

==="innercollapse" ou "outercollapse"===
:'''''Nota''': Esta opção ainda não está disponível no plugin do MediaWiki 1.18 ([[bugzilla:30352|bug #30352]]).''

Com estas duas classes é possível criar uma tabela contraída por defeito, apenas quando está ''incorporada'' dentro de outro objecto, como, por exemplo, outra tabela. Isto é particularmente útil quando se usa uma tabela expansível dentro de outras predefinições.

{| class=wikitable style="width:80%;" align=center
!Código!!Resultado
|-
|width=50%| 
<nowiki>{| class="wikitable </nowiki>'''outercollapse'''<nowiki>"
! Esta tabela não contrai
|-
| Mas tabela dentro desta célula

{| class="wikitable </nowiki>'''collapsible innercollapse'''<nowiki>"
! Contrai-se
|-
| Ocultando esta frase
|}

|}</nowiki>
|style="width:50%; text-align:center;"|
{| class="wikitable outercollapse"
! Esta tabela não contrai
|-
| Mas tabela dentro desta célula
{| class="wikitable collapsible innercollapse"
! Contrai-se
|-
| Ocultando esta frase
|}
|}

|}

==Outras notas==
===Tabelas ordenáveis===
Tabelas expansíveis podem ser combinadas com [[Ajuda:Ordenar|tabelas ordenáveis]] sem dificuldade.

{| class=wikitable style="width:80%;" align=center
!Código!!Resultado
|-
|width=50%| 
<nowiki>{| class="wikitable </nowiki>'''mw-collapsible sortable'''<nowiki>"
!Nome!!Pontuação
|-
|João||59
|-
|Joana||100
|-
|Xavier||72
|}</nowiki>
|style="width:50%; text-align:center;"|
{|class="wikitable sortable mw-collapsible"
!Nome!!Pontuação
|-
|João||59
|-
|Joana||100
|-
|Xavier||72
|}
|}

===Personalização===
Utilizadores registados podem editar [[Special:MyPage/common.js|o common.js]] deles para mudar algumas da variáveis usadas.

<source lang=javascript>
autoCollapse = 4 //número de tabelas expansíveis numa página antes que autocollapse active-se (padrão=2)
var collapseCaption = 'collapse' //texto do link [hide] (padrão='esconder')
var expandCaption = 'uncollapse' //texto do link [show] (padrão='expandir')
</source>

===Outros elementos em HTML===
O novo plugin do MediaWiki 1.18 pode ser usado também com outros tipos de elementos que não sejam tabelas, tais como <tt><nowiki><div></nowiki></tt>, <tt><nowiki><span></nowiki></tt> ou listas <tt><nowiki><ol></nowiki></tt> e <tt><nowiki><ul></nowiki></tt>. No entanto, a versão antiga do código que torna as tabelas expansíveis e contraíveis funciona ''apenas em tabelas'', por isso as classes <code>collapsible</code>, <code>collapsed</code>, etc, não funcionaram em outros elementos, tais como <tt><nowiki><div></nowiki></tt> ou <tt><nowiki><span></nowiki></tt>. Há uma funcionalidade semelhante para ser usada em <tt><nowiki><div></nowiki></tt>, de nome "NavFrame". Consulte [[Wikimotorpedia:NavFrame]].

==Ver também==
* [[meta:Help:Collapsing]]
* [[mw:Manual:Collapsible elements]]
* [[testwiki:User:Krinkle/CollapsingTestpageMw|''Test Wikimotorpedia - Collapsing Testpage'']] - Página com exemplos de uso do novo plugin
{{DEFAULTSORT:{{PAGENAME}}}}
[[Categoria:!Ajuda]]

[[en:Help:Collapsing]]

Ajuda:Collapsing - Histórico de revisões

Calimero0000: Criou nova página com '{{Notícia|As antigas ''collapsible tables'' que eram descritas nesta página tornaram-se obsoletas. As predefinições que ainda a utilizam devem ser migradas para o nov...'