3 167
edições
Mudanças
Criação da Documentação da Predefinição Ficha.
{{distinguish|Predefinição:Userbox}}
{{Documentation subpage}}
<includeonly>{{Lua|Módulo:Ficha}}</includeonly>
{{Parameter names example
|nome={{PAGENAME}} <!--|filha |subcaixa |descat--> |título |acima |subcabeçalho |subcabeçalho1 |subcabeçalho2={{{subcabeçalho2}}}<br/>......
|imagem|legenda |imagem1|legenda1 |imagem2|legenda2={{{legenda2}}}<br/>......
|cabeçalho1=<div style="border-top:1px dashed #ccc;">{{{cabeçalho1}}}<br/>{{nobold|( ''ou'' )}}</div>
|rótulo2={{{rótulo1}}} |dados2={{{dados1}}}
|dados3=( ''ou'' ) |dados4=<div style="padding-bottom:0.25em;border-bottom:1px dashed #ccc;">{{{dados1}}}</div>
|cabeçalho5={{{cabeçalho2}}}<br/><div style="padding:0.75em 0 0.5em;">{{nobold|( ''ou'' )}}</div>
|rótulo6={{{rótulo2}}} |dados6={{{dados2}}}
|dados7=( ''ou'' ) |dados8=<div style="padding-bottom:0.25em;border-bottom:1px dashed #ccc;">{{{dados2}}}</div>
|dados9=<div style="padding:0.75em 0 0.5em;">( ''etc'' )</div>
|abaixo
}}
A predefinição em a intenção de ser uma metapredefinição: uma predefinição usada para construir outras predefinições. '''Nota''': No geral, não é para ser usada diretamente num artigo, mas pode ser usada uma vez ou outra caso necessário.
== Uso ==
Para <code><nowiki>[[Predefinição:Ficha algumtópico]]</nowiki></code> ou <code><nowiki>[[Predefinição:Info/algumtópico]]</nowiki></code>, o código aparece dessa forma, simplificado:
<pre>
{{Ficha
| nome = {{{name|{{{nome|{{PAGENAME}}}}}}}}
| imagem = {{{image|{{{imagem|}}}}}}
| legenda1 = {{{caption|{{{legenda|}}}}}}
| rótulo1 = Nomes anteriores
| dados1 = {{{former_names|{{{nomes_anteriores|}}}}}}
| cabeçalho2 = Informação geral
| rótulo3 = Status
| dados3 = {{{status|}}}
... <!-- etc. -->
}}
</pre>
== Parâmetros de controlo opcionais ==
; nome : Se este parâmetro estiver presente, serão adicionados links "ver/discutir/editar" ao fim da infocaixa, que apontam para a página nomeada. Pode usar o valor <nowiki>{{subst:PAGENAME}}</nowiki>; no entanto, isto é raramente o que quer, porque enviará utilizadoras(es) ao dar click nestes links numa infocaixa num artigo ao código da predefinição, em vez dos dados da infocaixa que provavelmente querem.
; filha : Veja a secção [[#Incorporação|Incorporação]] para detalhes. Se estiver definida com "sim", esta infocaixa filha deve possuir título mas não o parâmetro nome. O parâmetro é vazio por padrão, defina-o como "sim" para ativá-lo.
; subcaixa : Veja a secção [[#Subboxes|Subcaixas]] para detalhes. Se estiver definida como "sim", esta subcaixa deve possuir nome mas não o parâmetro nome. O parâmetro é vazio por padrão, defina-o como "sim" para ativá-lo. Não tem efeito caso o parâmetro '''filha''' também estiver definido como "sim".
; descat : Se estiver definido como "sim", a página atual não será autocategorizada numa categoria de manutenção quando a infocaixa gerada tiver alguns problemas ou nenhuma secção de dados visível. Deixe-o vazio por padrão ou defina-o como "sim" para ativá-lo.
== Parâmetros de conteúdo ==
=== Título ===
Há duas maneiras diferentes para pôr um título numa infocaixa. Uma contém o título dentro da borda da infocaixa na célula mais acima da tabela, a outra põe-no como uma legenda no topo da tabela. Pode usar as duas maneiras juntas se quiser, ou apenas uma ou a outra, ou até nenhuma (embora não seja recomendado):
; título : Texto para pôr na legenda sobre o topo da tabela (ou como cabeçalho de secção antes do conteúdo inteiro desta tabela, caso seja uma infocaixa filha). Por razões de acessibilidade, esta é a alternativa mais recomendada.
; acima : Texto para pôr dentro da célula mais acima da tabela.
; subcabeçalho(n) : campos de título adicionais abaixo de {{{título}}} e {{{acima}}}, mas antes de imagens.
Exemplos:
{{Ficha
| nome = Ficha/doc
| título = Texto na legenda sobre a infocaixa in caption over infobox
| subcabeçalho = Subcabeçalho da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
<pre style="overflow:auto">
{{Ficha
| nome = {{subst:PAGENAME}}
| título = Texto na legenda sobre a infocaixa in caption over infobox
| subcabeçalho = Subcabeçalho da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
</pre>{{clear}}
{{Ficha
| nome = Ficha/doc
| acima = Texto na célula mais acima da infocaixa
| subcabeçalho = Subcaixa da infocaixa
| subcabeçalho2 = Segunda subcaixa da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
<pre style="overflow:auto">
{{Ficha
| nome = {{subst:PAGENAME}}
| acima = Texto na célula mais acima da infocaixa
| subcabeçalho = Subcaixa da infocaixa
| subcabeçalho2 = Segunda subcaixa da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
</pre>{{clear}}
=== Imagens de ilustração ===
; imagem(n) : imagens para exibir no topo da predefiição. Use sintaxe de imagem completa, por exemplo <nowiki>[[Ficheiro:example.png|200px|alt=Texto alt de exemplo]]</nowiki>. Imagem é centralizada por padrão. Veja [[WP:ALT]] para mais sobre texto alt.
; legenda(n) : Texto para pôr embaixo das imagens.
=== Dados principais ===
; cabeçalho(n) : Texto para usar como o cabeçalho em fileira n.
; rótulo(n) : Texto para usar como um rótulo em fileira n.
; dados(n) : Texto para exibir como dado em fileira n.
Nota: para qualquer valor dado para (n), nem todas as combinações de parâmetros são permitidas. A presença de um {{parâmetro|cabeçalho''(n)''}} causará o {{parâmetro|dados''(n)''}} correspondente (e {{parâmetro|linha-classe''(n)''}} {{parâmetro|rótulo''(n)''}}, veja abaixo) ser ignorado; a ausência de um {{parâmetro|dados''(n)''}} causará o {{parâmetro|rótulo''(n)''}} correspondente ser ignorado. Combinações válidas para uma única fileira são:
* {{parâmetro|classe''(n)''}} {{parâmetro|cabeçalho''(n)''}}
* {{parâmetro|linha-classe''(n)''}} {{parâmetro|classe''(n)''}} {{parâmetro|dados''(n)''}}
* {{parâmetro|linha-classe''(n)''}} {{parâmetro|rótulo''(n)''}} {{parâmetro|classe''(n)''}} {{parâmetro|dados''(n)''}}
Veja a renderização de cabeçalho4, rótulo e dados4 na secção [[#Exemplos|Exemplos]] abaixo.
==== Tornar campos de dados opcionais ====
Uma fileira com um rótulo mas nenhum dado não é exibida. Isto permite que a criação fácil de fileiras de conteúdo de infocaixa opcionais. Para fazer uma fileira opcional use um parâmetro que tem um string vazio como padrão, como o seguinte:
<pre style="overflow:auto">
| rótulo5 = População
| dados5 = {{{população|}}}
</pre>{{clear}}
Desta maneira, se um artigo não definir o parâmetro população em sua infocaixa, a fileira não será exibida.
Para campos mais complexos com conteúdos pré-formatados que ainda estariam presentes mesmo se o parâmetro não estivesse definido, pode juntá-los todos num declaração "#if" para fazer toda a coisa desaparecer quando o parâmetro não for usado. Por exemplo, a declaração "#if" no próximo exemplo diz "#if (#se):o parâmetro ''massa'' foi suprido |então exibi-lo, seguido por 'kg'":
<pre style="overflow:auto">
| rótulo6 = Massa
| dados6 = {{ #if: {{{massa|}}} | {{{massa}}} kg }}
</pre>{{clear}}
Para mais sobre #if, veja [[meta:ParserFunctions##if:|aqui]].
==== Esconder cabeçalhos quando todos os dados forem ocultados ====
Pode também tornar cabeçalhos opcionais de uma maneira similar. Considere este exemplo:
{{Ficha
| título = Exemplo de um cabeçalho indesejável
| cabeçalho1 = Cabeçalho indesejável
| rótulo2 = Item 1 | dados2 =
| rótulo3 = Item 2 | dados3 =
| rótulo4 = Item 3 | dados4 =
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
<pre style="overflow:auto">
{{Ficha
| título = Exemplo de um cabeçalho indesejável
| cabeçalho1 = Cabeçalho indesejável
| rótulo2 = Item 1 | dados2 =
| rótulo3 = Item 2 | dados3 =
| rótulo4 = Item 3 | dados4 =
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
</pre>{{clear}}
Se quiser que o primeiro cabeçalho apareça somente se um ou mais compos de dados que caem sobre ele, pode ser usado o seguinte padrão como exemplo de como o fazer:
{{Ficha
| título = Exemplo de um cabeçalho opcional
| cabeçalho1 = {{ #if: {{{item1|}}}{{{item2|}}}{{{item3|}}} | Cabeçalho opcional }}
| rótulo2 = Item 1 | dados2 = {{{item1|}}}
| rótulo3 = Item 2 | dados3 = {{{item2|}}}
| rótulo4 = Item 3 | dados4 = {{{item3|}}}
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
<pre style="overflow:auto">
{{Ficha
| título = Exemplo de um cabeçalho opcional
| cabeçalho1 = {{ #if: {{{item1|}}}{{{item2|}}}{{{item3|}}} | Cabeçalho opcional }}
| rótulo2 = Item 1 | dados2 = {{{item1|}}}
| rótulo3 = Item 2 | dados3 = {{{item2|}}}
| rótulo4 = Item 3 | dados4 = {{{item3|}}}
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
</pre>{{clear}}
cabeçalho1 será mostrado caso qualquer item1, item2 ou item3 for definido. Se nenhum dos três parâmetros for definido, o cabeçalho não será mostrado e nenhuma fileira vazia aparece antes do próximo conteúdo estático. O truque para isto é que o "#if" retorna falso somente se não haja nada na secção condicional, então a declaração irá falhar somente se todos os três, item1, item2 e item3, forem indefinidos.
Note que tal truque possa ser às vezes muito complexo para testar caso haja muitos itens de dados cujo valor depende de testes complexos (ou quando uma fileira de dados for gerada por uma invocação desta predefinição como uma [[#Subcaixas|subcaixa]]).
=== Rodapé ===
; abaixo : Texto para pôr na célula de baixo. A célula de baixo tem a intenção de ser usada para notas de rodapé, "ver também" e outra informação relacionada.
== Parâmetros de apresentação ==
=== Títulos em itálico ===
Títulos de artigos com infocaixas podem tornar-se itálicos ao passar o parâmetro <code>título itálico</code>.
* Ligue títulos em itálicos ao passar {{parâmetro|título itálico|<nowiki>{{{título itálico|}}}</nowiki>}} da infocaixa.
* Desligar por padrão (particularmente porque somente letras do alfabeto latino podem ser renderizados seguramente neste estilo e itálico pode ser necessário para distinguir a língua estrangeira da língua portuguesa local somente com as letras do alfabeto latino, mas seria difícil de ler com outros alfabetos) mas permitir algumas instâncias para utilizar estilo em itálico ao passar {{parâmetro|título itálico|<nowiki>{{{título itálico|não}}}</nowiki>}}
* Não permitir títulos em itálico ao não passar sequer o parâmetro.
=== Estilização com CSS ===
; corpo-estilo : Aplica-se à tabela de infocaixa como um todo
; título-estilo : Aplica-se somente à legenda de título. Adicionar uma cor de fundo não é aconselhável, já que o texto é renderizado "fora" da infocaixa.
; acima-estilo : Aplica-se somente à célula "acima" no topo. O estilo padrão tem font-size:125%; visto que esta célula é comummente usada para um título. Caso queira usar a célula acima para texto de tamanho regular, inclua "font-size:100%;" no acima-estilo.
; imagem-estilo : Aplica-se à célula em que a imagem está. Isto inclui o texto da legenda de imagem, mas deve definir propriedades de texto com legenda-estilo em vez de imagem-estilo para caso a legenda seja movida para fora da célula no futuro.
; legenda-estilo : Aplica-se ao texto da legenda de imagem.
; linha-estilo(n) : O parâmetro é inserido ao atributo <code>style</code> para a fileira especificado.
; cabeçalho-estilo : Aplica-se a todas as células de cabeçalho
; rótulo-estilo : Aplica-se a todas as células de rótulo
; dados-estilo : Aplica-se a todas as células de dados
; abaixo-estilo : Aplica-se somente à célula abaixo
=== Classes de HTML e microformatos ===
; corpo-classe : Este parâmetro é inserido ao atributo <code>class</code> para a infocaixa como um todo.
; título-classe : Este parâmetro é inserido ao atributo <code>class</code> para a legenda '''título''' da infocaixa.
; acima-classe : Este parâmetro é inserido ao atributo <code>class</code> para a célula '''acima''' da infocaixa.
; subcabeçalho-linha-classe(n) : Este parâmetro é inserido ao atributo <code>class</code> para a fileira completa da tabela em que '''subcabeçalho''' está.
; subcabeçalho-classe(n) : Este parâmetro inserido ao atributo <code>class</code> para o '''subcabeçalho''' da infocaixa.
; imagem-linha-classe(n) : Estes parâmetros são inseridos ao atributo <code>class</code> para a fileira completa da tabela em que sua respetiva '''imagem''' esteja.
; imagem-classe : Este parâmetro é inserido ao atributo <code>class</code> para a '''imagem'''.
; linha-classe(n) : Este parâmetro é inserido ao atributo <code>class</code> para a fileira especificada, inclusive as células '''rótulo''' e '''dados'''.
; classe(n) : Este parâmetro é inserido ao atributo <code>class</code> para a célula '''dados''' da fileira especificada. Se não há nenhuma célula '''dados''', não há nenhum efeito.
; abaixo-classe : Este parâmetro é inserido ao atributo <code>class</code> para a célula '''abaixo''' da infocaixa.
Esta predefinição suporta a adição de informação de microformato. Isto é feito ao adicionar atributos "class" a várias células de dados, a indicar que tipo de informação contém. Múltiplos nomes de classes podem ser especificados, separados por espaços, alguns deles usados como seletoras para estilização personalizada de acordo com uma política de projeto ou com a skin selecionada nas preferências de usuários, outros usados para microformatos.
Para sinalizar uma infocaixa como informação que contém [[hCard]], por exemplo, adicione o seguinte parâmetro:
<pre style="overflow:auto">
| corpo-classe = vcard
</pre>{{clear}}
E para cada fileira que contém uma célula de dados que faz parte do vcard, adicione um parâmetro de classe correspondente:
<pre style="overflow:auto">
| classe1 = fn
| classe2 = org
| classe3 = tel
</pre>{{clear}}
...e assim por diante. Pode-se dar classes para "acima" e "título", já que estes são comummente usados para exibir o nome do assunto da infocaixa.
Veja [[microformato]] para mais informação sobre microformatos em geral.
== Exemplos ==
Perceba como a fileira não aparece na infocaixa exibida quando um '''rótulo''' é definido sem uma célula '''dados''' acompanhante, e como eles todos são exibidos quando um '''cabeçalho''' é definido na mesma linha que uma célula '''dados'''. Também perceba que '''subcabeçalhos''' são possuem um estilo negrito por padrão como os '''cabeçalhos''' usados para dividir a secção de dados principais, porque esta função é para a célula '''acima''' :
{{Ficha
|nome = Ficha/doc
|corpo-estilo =
|título-estilo =
|acima-estilo = background:#cfc;
|subcabeçalho-estilo =
|título = Ficha de teste
|acima = Texto acima
|subcabeçalho = Subcabeçalho acima de imagem
|subcabeçalho2 = Segundo subcabeçalho
|imagem-estilo =
|legenda-estilo =
|imagem = [[Ficheiro:Example-serious.jpg|200px|alt=Texto alt de exemplo]]
|legenda = Legenda exibida abaixo de Ficheiro:Example-serious.jpg
|cabeçalho-estilo = background:#ccf;
|rótulo-estilo = background:#ddf;
|dados-estilo =
|cabeçalho1 = Cabeçalho definido sozinho
| rótulo1 =
| dados1 =
|cabeçalho2 =
| rótulo2 = Rótulo definido sozinho que não é exibido (necessita de dados ou é suprimido)
| dados2 =
|cabeçalho3 =
| rótulo3 =
| dados3 = Dado definido sozinho
|cabeçalho4 = Todos os três definidos (cabeçalho, rótulo, dados, todos com o mesmo número)
| rótulo4 = não é exibido (mesmo número que um cabeçalho)
| dados4 = não é exibido (mesmo número que um cabeçalho)
|cabeçalho5 =
| rótulo5 = Rótulo e dados definidos (rótulo)
| dados5 = Rótulo e dados definidos (dados)
|abaixo-estilo = background:#ddf;
|abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
|nome = {{subst:PAGENAME}}
|corpo-estilo =
|título-estilo =
|acima-estilo = background:#cfc;
|subcabeçalho-estilo =
|título = Ficha de teste
|acima = Texto acima
|subcabeçalho = Subcabeçalho acima de imagem
|subcabeçalho2 = Segundo subcabeçalho
|imagem-estilo =
|legenda-estilo =
|imagem = [[Ficheiro:Example-serious.jpg|200px|alt=Texto alt de exemplo]]
|legenda = Legenda exibida abaixo de Ficheiro:Example-serious.jpg
|cabeçalho-estilo = background:#ccf;
|rótulo-estilo = background:#ddf;
|dados-estilo =
|cabeçalho1 = Cabeçalho definido sozinho
| rótulo1 =
| dados1 =
|cabeçalho2 =
| rótulo2 = Rótulo definido sozinho que não é exibido (necessita de dados ou é suprimido)
| dados2 =
|cabeçalho3 =
| rótulo3 =
| dados3 = Dado definido sozinho
|cabeçalho4 = Todos os três definidos (cabeçalho, rótulo, dados, todos com o mesmo número)
| rótulo4 = não é exibido (mesmo número que um cabeçalho)
| dados4 = não é exibido (mesmo número que um cabeçalho)
|cabeçalho5 =
| rótulo5 = Rótulo e dados definidos (rótulo)
| dados5 = Rótulo e dados definidos (dados)
|abaixo-estilo = background:#ddf;
|abaixo = Texto abaixo
}}
</pre>{{clear}}
Para este exemplo, os parâmetros '''corpo-estilo''' e '''rótulo-estilo''' são usados para ajustar a largura da infobox e definir uma largura padrão para a coluna de rótulos:
{{Ficha
|nome = Ficha/doc
|corpo-estilo = width:20em
|título-estilo =
|título = Ficha de testes
|cabeçalho-estilo =
|rótulo-estilo = width:33%
|dados-estilo =
|cabeçalho1 =
| rótulo1 = Rótulo 1
| dados1 = Dado 1
|cabeçalho2 =
| rótulo2 = Rótulo 2
| dados2 = Dado 2
|cabeçalho3 =
| rótulo3 = Rótulo 3
| dados3 = Dado 3
|cabeçalho4 = Cabeçalho 4
| rótulo4 =
| dados4 =
|cabeçalho5 =
| rótulo5 = Rótulo 5
| dados5 = Dado 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|abaixo-estilo =
|abaixo = Texto abaixo
}}
<pre style="overflow: auto">
{{Ficha
|nome = {{subst:PAGENAME}}
|corpo-estilo = width:20em
|título-estilo =
|título = Ficha de testes
|cabeçalho-estilo =
|rótulo-estilo = width:33%
|dados-estilo =
|cabeçalho1 =
| rótulo1 = Rótulo 1
| dados1 = Dado 1
|cabeçalho2 =
| rótulo2 = Rótulo 2
| dados2 = Dado 2
|cabeçalho3 =
| rótulo3 = Rótulo 3
| dados3 = Dado 3
|cabeçalho4 = Cabeçalho 4
| rótulo4 =
| dados4 =
|cabeçalho5 =
| rótulo5 = Rótulo 5
| dados5 = Dado 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|abaixo-estilo =
|abaixo = Texto abaixo
}}
</pre>{{clear}}
== Incorporação ==
Uma predefinição de infocaixa pode ser incorporada a outra ao usar o parâmetro {{parâmetro|filha}}. Esta função pode ser usada para criar uma infocaixa moduar ou para criar secções lógicas melhor definidas.
{{Ficha
|título = Título de nível máximo
| dados1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| dados2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
|título = Título de nível máximo
| dados1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| dados2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}</pre>{{clear}}
Note, nos exemplos acima, a infocaixa filha é posta num campo <code>dados</code>, não num campo <code>cabeçalho</code>. Perceba que subcabeçalhos não estão em negrito caso negrito não seja explicitamente especificado. Para obter negrito em cabeçalhos, coloque a infocaixa filha num campo '''cabeçalho''' (mas não num campo '''rótulo''' porque não seria exibida!), use ou
{{Ficha
|título = Título de nível máximo
| cabeçalho1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dado1 = Dados 1.1
}}
| cabeçalho2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
|título = Título de nível máximo
| cabeçalho1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dado1 = Dados 1.1
}}
| cabeçalho2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
</pre>{{clear}}
ou,
{{Ficha
| título = Título de nível máximo
| cabeçalho1 = Primeira subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| cabeçalho2 = Segunda subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
| título = Título de nível máximo
| cabeçalho1 = Primeira subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| cabeçalho2 = Segunda subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
</pre>{{clear}}
Note que omitir o parâmetro {{parâmetro|título}}, e não incluir qualquer texto que precede a infocaixa incorporada, pode resultar em fileiras de tabela em branco falsos e criar vãos ma apresentação visual.
== Subcaixas ==
Um método alternativo para incorporar é usar {{parâmetro|subcaixa|{{var|sim}}}}, que remove a borda externa da infocaixa, mas preserva a estrutura interior. Uma função desta abordagem é que as caixas mãe e filha não necessitam de ter a mesma estrutura e os campos rótulo e dados não são alinhados entre as caixas mãe e filha porque não estão na mesma tabela mãe.
{{Ficha
|cabeçalho-estilo = background-color:#eee;
|rótulo-estilo = background-color:#eee;
|cabeçalho1 = Principal 1
|cabeçalho2 = Principal 2
| dados3 = {{Ficha | subcaixa = sim
|cabeçalho-estilo = background-color:#ccc;
|rótulo-estilo = background-color:#ddd;
|cabeçalho1 = Sub 3-1
|cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| dados4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Rótulo 4-1 | dados1 = Dado 4-1
}}
| rótulo5 = Rótulo 5 | dados5 = Dado 5
|cabeçalho6 = Principal 6
}}
<pre style="overflow:auto">
{{Ficha
|cabeçalho-estilo = background-color:#eee;
|rótulo-estilo = background-color:#eee;
|cabeçalho1 = Principal 1
|cabeçalho2 = Principal 2
| dados3 = {{Ficha | subcaixa = sim
|cabeçalho-estilo = background-color:#ccc;
|rótulo-estilo = background-color:#ddd;
|cabeçalho1 = Sub 3-1
|cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| dados4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Rótulo 4-1 | dados1 = Dado 4-1
}}
| rótulo5 = Rótulo 5 | dados5 = Dado 5
|cabeçalho6 = Principal 6
}}
</pre>{{clear}}
Técnicas de incorporação similares podem ser usadas dentro de parâmetros de conteúdo de algumas outras predefinições que geram tabelas (como {{tlg|Sidebar}}) :
{{Sidebar/Testes
| navbar = off
| headingstyle = background-color:#eee;
| heading1 = Cabeçalho 1
| heading2 = Cabeçalho 2
| content3 = {{Ficha | subcaixa = sim
| cabeçalho-estilo = background-color:#ccc;
| rótulo-estilo = background-color:#ddd;
| cabeçalho1 = Sub 3-1
| cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| content4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Label 4-1 | dado1 = Dado 4-1
}}
| heading5 = Cabeçalho 5
}}
<pre style="overflow:auto">
{{Sidebar
| navbar = off
| headingstyle = background-color:#eee;
| heading1 = Cabeçalho 1
| heading2 = Cabeçalho 2
| content3 = {{Ficha | subcaixa = sim
| cabeçalho-estilo = background-color:#ccc;
| rótulo-estilo = background-color:#ddd;
| cabeçalho1 = Sub 3-1
| cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| content4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Label 4-1 | dado1 = Dado 4-1
}}
| heading5 = Cabeçalho 5
}}
</pre>{{clear}}
Note que o padding padrão da célula de dado da mãe que contém cada subcaixa ainda está visível, então as subcaixas são um bocadinho mais estreitas que a caixa mãe e há um espaçamento vertical mais alto entre células padrão da caixa mãe do que entre células de subcaixas distintas.
== Controlar quebra de linha em listas sem bullets incorporadas ==
Predefinição {{tlx|nbsp}} pode ser usada com {{tlx|wbr}} e {{tlx|nowrap}} para controlar quebra de linha em listas sem bullets incorporadas em infocaixas (ex. lista de elenco), para prevenir entradas longas e envoltas de ser confundidas com múltiplas entradas.
== Sintaxe em branco completa ==
(Nota: não há limite de número de fileiras possíveis, mas somente 20 são exibidas abaixo. Apenas aumente a numeração o quanto necessário. Os parâmetros "class" de microformatos também são omitidos, visto que não são comummente usados.)
<pre style="overflow:auto">
{{Ficha
| nome = {{subst:PAGENAME}}
| filha = {{{filha|}}}
| subcaixa = {{{subcaixa|}}}
| título itálico = {{{título itálico|não}}}
| corpo-estilo =
| título-estilo =
| acima-estilo =
| subcabeçalho-estilo =
| título =
| acima =
| subcabeçalho =
| imagem-estilo =
| legenda-estilo =
| imagem =
| legenda =
| imagem2 =
| legenda2 =
| cabeçalho-estilo =
| rótulo-estilo =
| dados-estilo =
| cabeçalho1 =
| rótulo1 =
| dados1 =
| cabeçalho2 =
| rótulo2 =
| dados2 =
| cabeçalho3 =
| rótulo3 =
| dados3 =
| cabeçalho4 =
| rótulo4 =
| dados4 =
| cabeçalho5 =
| rótulo5 =
| dados5 =
| cabeçalho6 =
| rótulo6 =
| dados6 =
| cabeçalho7 =
| rótulo7 =
| dados7 =
| cabeçalho8 =
| rótulo8 =
| dados8 =
| cabeçalho9 =
| rótulo9 =
| dados9 =
| cabeçalho10 =
| rótulo10 =
| dados10 =
| cabeçalho11 =
| rótulo11 =
| dados11 =
| cabeçalho12 =
| rótulo12 =
| dados12 =
| cabeçalho13 =
| rótulo13 =
| dados13 =
| cabeçalho14 =
| rótulo14 =
| dados14 =
| cabeçalho15 =
| rótulo15 =
| dados15 =
| cabeçalho16 =
| rótulo16 =
| dados16 =
| cabeçalho17 =
| rótulo17 =
| dados17 =
| cabeçalho18 =
| rótulo18 =
| dados18 =
| cabeçalho19 =
| rótulo19 =
| dados19 =
| cabeçalho20 =
| rótulo20 =
| dados20 =
| abaixo-estilo =
| abaixo =
}}
</pre>{{clear}}
{{Documentation subpage}}
<includeonly>{{Lua|Módulo:Ficha}}</includeonly>
{{Parameter names example
|nome={{PAGENAME}} <!--|filha |subcaixa |descat--> |título |acima |subcabeçalho |subcabeçalho1 |subcabeçalho2={{{subcabeçalho2}}}<br/>......
|imagem|legenda |imagem1|legenda1 |imagem2|legenda2={{{legenda2}}}<br/>......
|cabeçalho1=<div style="border-top:1px dashed #ccc;">{{{cabeçalho1}}}<br/>{{nobold|( ''ou'' )}}</div>
|rótulo2={{{rótulo1}}} |dados2={{{dados1}}}
|dados3=( ''ou'' ) |dados4=<div style="padding-bottom:0.25em;border-bottom:1px dashed #ccc;">{{{dados1}}}</div>
|cabeçalho5={{{cabeçalho2}}}<br/><div style="padding:0.75em 0 0.5em;">{{nobold|( ''ou'' )}}</div>
|rótulo6={{{rótulo2}}} |dados6={{{dados2}}}
|dados7=( ''ou'' ) |dados8=<div style="padding-bottom:0.25em;border-bottom:1px dashed #ccc;">{{{dados2}}}</div>
|dados9=<div style="padding:0.75em 0 0.5em;">( ''etc'' )</div>
|abaixo
}}
A predefinição em a intenção de ser uma metapredefinição: uma predefinição usada para construir outras predefinições. '''Nota''': No geral, não é para ser usada diretamente num artigo, mas pode ser usada uma vez ou outra caso necessário.
== Uso ==
Para <code><nowiki>[[Predefinição:Ficha algumtópico]]</nowiki></code> ou <code><nowiki>[[Predefinição:Info/algumtópico]]</nowiki></code>, o código aparece dessa forma, simplificado:
<pre>
{{Ficha
| nome = {{{name|{{{nome|{{PAGENAME}}}}}}}}
| imagem = {{{image|{{{imagem|}}}}}}
| legenda1 = {{{caption|{{{legenda|}}}}}}
| rótulo1 = Nomes anteriores
| dados1 = {{{former_names|{{{nomes_anteriores|}}}}}}
| cabeçalho2 = Informação geral
| rótulo3 = Status
| dados3 = {{{status|}}}
... <!-- etc. -->
}}
</pre>
== Parâmetros de controlo opcionais ==
; nome : Se este parâmetro estiver presente, serão adicionados links "ver/discutir/editar" ao fim da infocaixa, que apontam para a página nomeada. Pode usar o valor <nowiki>{{subst:PAGENAME}}</nowiki>; no entanto, isto é raramente o que quer, porque enviará utilizadoras(es) ao dar click nestes links numa infocaixa num artigo ao código da predefinição, em vez dos dados da infocaixa que provavelmente querem.
; filha : Veja a secção [[#Incorporação|Incorporação]] para detalhes. Se estiver definida com "sim", esta infocaixa filha deve possuir título mas não o parâmetro nome. O parâmetro é vazio por padrão, defina-o como "sim" para ativá-lo.
; subcaixa : Veja a secção [[#Subboxes|Subcaixas]] para detalhes. Se estiver definida como "sim", esta subcaixa deve possuir nome mas não o parâmetro nome. O parâmetro é vazio por padrão, defina-o como "sim" para ativá-lo. Não tem efeito caso o parâmetro '''filha''' também estiver definido como "sim".
; descat : Se estiver definido como "sim", a página atual não será autocategorizada numa categoria de manutenção quando a infocaixa gerada tiver alguns problemas ou nenhuma secção de dados visível. Deixe-o vazio por padrão ou defina-o como "sim" para ativá-lo.
== Parâmetros de conteúdo ==
=== Título ===
Há duas maneiras diferentes para pôr um título numa infocaixa. Uma contém o título dentro da borda da infocaixa na célula mais acima da tabela, a outra põe-no como uma legenda no topo da tabela. Pode usar as duas maneiras juntas se quiser, ou apenas uma ou a outra, ou até nenhuma (embora não seja recomendado):
; título : Texto para pôr na legenda sobre o topo da tabela (ou como cabeçalho de secção antes do conteúdo inteiro desta tabela, caso seja uma infocaixa filha). Por razões de acessibilidade, esta é a alternativa mais recomendada.
; acima : Texto para pôr dentro da célula mais acima da tabela.
; subcabeçalho(n) : campos de título adicionais abaixo de {{{título}}} e {{{acima}}}, mas antes de imagens.
Exemplos:
{{Ficha
| nome = Ficha/doc
| título = Texto na legenda sobre a infocaixa in caption over infobox
| subcabeçalho = Subcabeçalho da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
<pre style="overflow:auto">
{{Ficha
| nome = {{subst:PAGENAME}}
| título = Texto na legenda sobre a infocaixa in caption over infobox
| subcabeçalho = Subcabeçalho da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
</pre>{{clear}}
{{Ficha
| nome = Ficha/doc
| acima = Texto na célula mais acima da infocaixa
| subcabeçalho = Subcaixa da infocaixa
| subcabeçalho2 = Segunda subcaixa da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
<pre style="overflow:auto">
{{Ficha
| nome = {{subst:PAGENAME}}
| acima = Texto na célula mais acima da infocaixa
| subcabeçalho = Subcaixa da infocaixa
| subcabeçalho2 = Segunda subcaixa da infocaixa
| cabeçalho = (o resto da infocaixa vai aqui)
}}
</pre>{{clear}}
=== Imagens de ilustração ===
; imagem(n) : imagens para exibir no topo da predefiição. Use sintaxe de imagem completa, por exemplo <nowiki>[[Ficheiro:example.png|200px|alt=Texto alt de exemplo]]</nowiki>. Imagem é centralizada por padrão. Veja [[WP:ALT]] para mais sobre texto alt.
; legenda(n) : Texto para pôr embaixo das imagens.
=== Dados principais ===
; cabeçalho(n) : Texto para usar como o cabeçalho em fileira n.
; rótulo(n) : Texto para usar como um rótulo em fileira n.
; dados(n) : Texto para exibir como dado em fileira n.
Nota: para qualquer valor dado para (n), nem todas as combinações de parâmetros são permitidas. A presença de um {{parâmetro|cabeçalho''(n)''}} causará o {{parâmetro|dados''(n)''}} correspondente (e {{parâmetro|linha-classe''(n)''}} {{parâmetro|rótulo''(n)''}}, veja abaixo) ser ignorado; a ausência de um {{parâmetro|dados''(n)''}} causará o {{parâmetro|rótulo''(n)''}} correspondente ser ignorado. Combinações válidas para uma única fileira são:
* {{parâmetro|classe''(n)''}} {{parâmetro|cabeçalho''(n)''}}
* {{parâmetro|linha-classe''(n)''}} {{parâmetro|classe''(n)''}} {{parâmetro|dados''(n)''}}
* {{parâmetro|linha-classe''(n)''}} {{parâmetro|rótulo''(n)''}} {{parâmetro|classe''(n)''}} {{parâmetro|dados''(n)''}}
Veja a renderização de cabeçalho4, rótulo e dados4 na secção [[#Exemplos|Exemplos]] abaixo.
==== Tornar campos de dados opcionais ====
Uma fileira com um rótulo mas nenhum dado não é exibida. Isto permite que a criação fácil de fileiras de conteúdo de infocaixa opcionais. Para fazer uma fileira opcional use um parâmetro que tem um string vazio como padrão, como o seguinte:
<pre style="overflow:auto">
| rótulo5 = População
| dados5 = {{{população|}}}
</pre>{{clear}}
Desta maneira, se um artigo não definir o parâmetro população em sua infocaixa, a fileira não será exibida.
Para campos mais complexos com conteúdos pré-formatados que ainda estariam presentes mesmo se o parâmetro não estivesse definido, pode juntá-los todos num declaração "#if" para fazer toda a coisa desaparecer quando o parâmetro não for usado. Por exemplo, a declaração "#if" no próximo exemplo diz "#if (#se):o parâmetro ''massa'' foi suprido |então exibi-lo, seguido por 'kg'":
<pre style="overflow:auto">
| rótulo6 = Massa
| dados6 = {{ #if: {{{massa|}}} | {{{massa}}} kg }}
</pre>{{clear}}
Para mais sobre #if, veja [[meta:ParserFunctions##if:|aqui]].
==== Esconder cabeçalhos quando todos os dados forem ocultados ====
Pode também tornar cabeçalhos opcionais de uma maneira similar. Considere este exemplo:
{{Ficha
| título = Exemplo de um cabeçalho indesejável
| cabeçalho1 = Cabeçalho indesejável
| rótulo2 = Item 1 | dados2 =
| rótulo3 = Item 2 | dados3 =
| rótulo4 = Item 3 | dados4 =
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
<pre style="overflow:auto">
{{Ficha
| título = Exemplo de um cabeçalho indesejável
| cabeçalho1 = Cabeçalho indesejável
| rótulo2 = Item 1 | dados2 =
| rótulo3 = Item 2 | dados3 =
| rótulo4 = Item 3 | dados4 =
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
</pre>{{clear}}
Se quiser que o primeiro cabeçalho apareça somente se um ou mais compos de dados que caem sobre ele, pode ser usado o seguinte padrão como exemplo de como o fazer:
{{Ficha
| título = Exemplo de um cabeçalho opcional
| cabeçalho1 = {{ #if: {{{item1|}}}{{{item2|}}}{{{item3|}}} | Cabeçalho opcional }}
| rótulo2 = Item 1 | dados2 = {{{item1|}}}
| rótulo3 = Item 2 | dados3 = {{{item2|}}}
| rótulo4 = Item 3 | dados4 = {{{item3|}}}
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
<pre style="overflow:auto">
{{Ficha
| título = Exemplo de um cabeçalho opcional
| cabeçalho1 = {{ #if: {{{item1|}}}{{{item2|}}}{{{item3|}}} | Cabeçalho opcional }}
| rótulo2 = Item 1 | dados2 = {{{item1|}}}
| rótulo3 = Item 2 | dados3 = {{{item2|}}}
| rótulo4 = Item 3 | dados4 = {{{item3|}}}
| cabeçalho5 = Cabeçalho estático
| rótulo6 = Item estático | dados6 = Valor estático
}}
</pre>{{clear}}
cabeçalho1 será mostrado caso qualquer item1, item2 ou item3 for definido. Se nenhum dos três parâmetros for definido, o cabeçalho não será mostrado e nenhuma fileira vazia aparece antes do próximo conteúdo estático. O truque para isto é que o "#if" retorna falso somente se não haja nada na secção condicional, então a declaração irá falhar somente se todos os três, item1, item2 e item3, forem indefinidos.
Note que tal truque possa ser às vezes muito complexo para testar caso haja muitos itens de dados cujo valor depende de testes complexos (ou quando uma fileira de dados for gerada por uma invocação desta predefinição como uma [[#Subcaixas|subcaixa]]).
=== Rodapé ===
; abaixo : Texto para pôr na célula de baixo. A célula de baixo tem a intenção de ser usada para notas de rodapé, "ver também" e outra informação relacionada.
== Parâmetros de apresentação ==
=== Títulos em itálico ===
Títulos de artigos com infocaixas podem tornar-se itálicos ao passar o parâmetro <code>título itálico</code>.
* Ligue títulos em itálicos ao passar {{parâmetro|título itálico|<nowiki>{{{título itálico|}}}</nowiki>}} da infocaixa.
* Desligar por padrão (particularmente porque somente letras do alfabeto latino podem ser renderizados seguramente neste estilo e itálico pode ser necessário para distinguir a língua estrangeira da língua portuguesa local somente com as letras do alfabeto latino, mas seria difícil de ler com outros alfabetos) mas permitir algumas instâncias para utilizar estilo em itálico ao passar {{parâmetro|título itálico|<nowiki>{{{título itálico|não}}}</nowiki>}}
* Não permitir títulos em itálico ao não passar sequer o parâmetro.
=== Estilização com CSS ===
; corpo-estilo : Aplica-se à tabela de infocaixa como um todo
; título-estilo : Aplica-se somente à legenda de título. Adicionar uma cor de fundo não é aconselhável, já que o texto é renderizado "fora" da infocaixa.
; acima-estilo : Aplica-se somente à célula "acima" no topo. O estilo padrão tem font-size:125%; visto que esta célula é comummente usada para um título. Caso queira usar a célula acima para texto de tamanho regular, inclua "font-size:100%;" no acima-estilo.
; imagem-estilo : Aplica-se à célula em que a imagem está. Isto inclui o texto da legenda de imagem, mas deve definir propriedades de texto com legenda-estilo em vez de imagem-estilo para caso a legenda seja movida para fora da célula no futuro.
; legenda-estilo : Aplica-se ao texto da legenda de imagem.
; linha-estilo(n) : O parâmetro é inserido ao atributo <code>style</code> para a fileira especificado.
; cabeçalho-estilo : Aplica-se a todas as células de cabeçalho
; rótulo-estilo : Aplica-se a todas as células de rótulo
; dados-estilo : Aplica-se a todas as células de dados
; abaixo-estilo : Aplica-se somente à célula abaixo
=== Classes de HTML e microformatos ===
; corpo-classe : Este parâmetro é inserido ao atributo <code>class</code> para a infocaixa como um todo.
; título-classe : Este parâmetro é inserido ao atributo <code>class</code> para a legenda '''título''' da infocaixa.
; acima-classe : Este parâmetro é inserido ao atributo <code>class</code> para a célula '''acima''' da infocaixa.
; subcabeçalho-linha-classe(n) : Este parâmetro é inserido ao atributo <code>class</code> para a fileira completa da tabela em que '''subcabeçalho''' está.
; subcabeçalho-classe(n) : Este parâmetro inserido ao atributo <code>class</code> para o '''subcabeçalho''' da infocaixa.
; imagem-linha-classe(n) : Estes parâmetros são inseridos ao atributo <code>class</code> para a fileira completa da tabela em que sua respetiva '''imagem''' esteja.
; imagem-classe : Este parâmetro é inserido ao atributo <code>class</code> para a '''imagem'''.
; linha-classe(n) : Este parâmetro é inserido ao atributo <code>class</code> para a fileira especificada, inclusive as células '''rótulo''' e '''dados'''.
; classe(n) : Este parâmetro é inserido ao atributo <code>class</code> para a célula '''dados''' da fileira especificada. Se não há nenhuma célula '''dados''', não há nenhum efeito.
; abaixo-classe : Este parâmetro é inserido ao atributo <code>class</code> para a célula '''abaixo''' da infocaixa.
Esta predefinição suporta a adição de informação de microformato. Isto é feito ao adicionar atributos "class" a várias células de dados, a indicar que tipo de informação contém. Múltiplos nomes de classes podem ser especificados, separados por espaços, alguns deles usados como seletoras para estilização personalizada de acordo com uma política de projeto ou com a skin selecionada nas preferências de usuários, outros usados para microformatos.
Para sinalizar uma infocaixa como informação que contém [[hCard]], por exemplo, adicione o seguinte parâmetro:
<pre style="overflow:auto">
| corpo-classe = vcard
</pre>{{clear}}
E para cada fileira que contém uma célula de dados que faz parte do vcard, adicione um parâmetro de classe correspondente:
<pre style="overflow:auto">
| classe1 = fn
| classe2 = org
| classe3 = tel
</pre>{{clear}}
...e assim por diante. Pode-se dar classes para "acima" e "título", já que estes são comummente usados para exibir o nome do assunto da infocaixa.
Veja [[microformato]] para mais informação sobre microformatos em geral.
== Exemplos ==
Perceba como a fileira não aparece na infocaixa exibida quando um '''rótulo''' é definido sem uma célula '''dados''' acompanhante, e como eles todos são exibidos quando um '''cabeçalho''' é definido na mesma linha que uma célula '''dados'''. Também perceba que '''subcabeçalhos''' são possuem um estilo negrito por padrão como os '''cabeçalhos''' usados para dividir a secção de dados principais, porque esta função é para a célula '''acima''' :
{{Ficha
|nome = Ficha/doc
|corpo-estilo =
|título-estilo =
|acima-estilo = background:#cfc;
|subcabeçalho-estilo =
|título = Ficha de teste
|acima = Texto acima
|subcabeçalho = Subcabeçalho acima de imagem
|subcabeçalho2 = Segundo subcabeçalho
|imagem-estilo =
|legenda-estilo =
|imagem = [[Ficheiro:Example-serious.jpg|200px|alt=Texto alt de exemplo]]
|legenda = Legenda exibida abaixo de Ficheiro:Example-serious.jpg
|cabeçalho-estilo = background:#ccf;
|rótulo-estilo = background:#ddf;
|dados-estilo =
|cabeçalho1 = Cabeçalho definido sozinho
| rótulo1 =
| dados1 =
|cabeçalho2 =
| rótulo2 = Rótulo definido sozinho que não é exibido (necessita de dados ou é suprimido)
| dados2 =
|cabeçalho3 =
| rótulo3 =
| dados3 = Dado definido sozinho
|cabeçalho4 = Todos os três definidos (cabeçalho, rótulo, dados, todos com o mesmo número)
| rótulo4 = não é exibido (mesmo número que um cabeçalho)
| dados4 = não é exibido (mesmo número que um cabeçalho)
|cabeçalho5 =
| rótulo5 = Rótulo e dados definidos (rótulo)
| dados5 = Rótulo e dados definidos (dados)
|abaixo-estilo = background:#ddf;
|abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
|nome = {{subst:PAGENAME}}
|corpo-estilo =
|título-estilo =
|acima-estilo = background:#cfc;
|subcabeçalho-estilo =
|título = Ficha de teste
|acima = Texto acima
|subcabeçalho = Subcabeçalho acima de imagem
|subcabeçalho2 = Segundo subcabeçalho
|imagem-estilo =
|legenda-estilo =
|imagem = [[Ficheiro:Example-serious.jpg|200px|alt=Texto alt de exemplo]]
|legenda = Legenda exibida abaixo de Ficheiro:Example-serious.jpg
|cabeçalho-estilo = background:#ccf;
|rótulo-estilo = background:#ddf;
|dados-estilo =
|cabeçalho1 = Cabeçalho definido sozinho
| rótulo1 =
| dados1 =
|cabeçalho2 =
| rótulo2 = Rótulo definido sozinho que não é exibido (necessita de dados ou é suprimido)
| dados2 =
|cabeçalho3 =
| rótulo3 =
| dados3 = Dado definido sozinho
|cabeçalho4 = Todos os três definidos (cabeçalho, rótulo, dados, todos com o mesmo número)
| rótulo4 = não é exibido (mesmo número que um cabeçalho)
| dados4 = não é exibido (mesmo número que um cabeçalho)
|cabeçalho5 =
| rótulo5 = Rótulo e dados definidos (rótulo)
| dados5 = Rótulo e dados definidos (dados)
|abaixo-estilo = background:#ddf;
|abaixo = Texto abaixo
}}
</pre>{{clear}}
Para este exemplo, os parâmetros '''corpo-estilo''' e '''rótulo-estilo''' são usados para ajustar a largura da infobox e definir uma largura padrão para a coluna de rótulos:
{{Ficha
|nome = Ficha/doc
|corpo-estilo = width:20em
|título-estilo =
|título = Ficha de testes
|cabeçalho-estilo =
|rótulo-estilo = width:33%
|dados-estilo =
|cabeçalho1 =
| rótulo1 = Rótulo 1
| dados1 = Dado 1
|cabeçalho2 =
| rótulo2 = Rótulo 2
| dados2 = Dado 2
|cabeçalho3 =
| rótulo3 = Rótulo 3
| dados3 = Dado 3
|cabeçalho4 = Cabeçalho 4
| rótulo4 =
| dados4 =
|cabeçalho5 =
| rótulo5 = Rótulo 5
| dados5 = Dado 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|abaixo-estilo =
|abaixo = Texto abaixo
}}
<pre style="overflow: auto">
{{Ficha
|nome = {{subst:PAGENAME}}
|corpo-estilo = width:20em
|título-estilo =
|título = Ficha de testes
|cabeçalho-estilo =
|rótulo-estilo = width:33%
|dados-estilo =
|cabeçalho1 =
| rótulo1 = Rótulo 1
| dados1 = Dado 1
|cabeçalho2 =
| rótulo2 = Rótulo 2
| dados2 = Dado 2
|cabeçalho3 =
| rótulo3 = Rótulo 3
| dados3 = Dado 3
|cabeçalho4 = Cabeçalho 4
| rótulo4 =
| dados4 =
|cabeçalho5 =
| rótulo5 = Rótulo 5
| dados5 = Dado 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|abaixo-estilo =
|abaixo = Texto abaixo
}}
</pre>{{clear}}
== Incorporação ==
Uma predefinição de infocaixa pode ser incorporada a outra ao usar o parâmetro {{parâmetro|filha}}. Esta função pode ser usada para criar uma infocaixa moduar ou para criar secções lógicas melhor definidas.
{{Ficha
|título = Título de nível máximo
| dados1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| dados2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
|título = Título de nível máximo
| dados1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| dados2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}</pre>{{clear}}
Note, nos exemplos acima, a infocaixa filha é posta num campo <code>dados</code>, não num campo <code>cabeçalho</code>. Perceba que subcabeçalhos não estão em negrito caso negrito não seja explicitamente especificado. Para obter negrito em cabeçalhos, coloque a infocaixa filha num campo '''cabeçalho''' (mas não num campo '''rótulo''' porque não seria exibida!), use ou
{{Ficha
|título = Título de nível máximo
| cabeçalho1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dado1 = Dados 1.1
}}
| cabeçalho2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
|título = Título de nível máximo
| cabeçalho1 = {{Ficha | descat = sim | filha = sim
|título = Primeira subsecção
| rótulo1 = Rótulo 1.1
| dado1 = Dados 1.1
}}
| cabeçalho2 = {{Ficha | descat = sim | filha = sim
|título = Segunda subsecção
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
</pre>{{clear}}
ou,
{{Ficha
| título = Título de nível máximo
| cabeçalho1 = Primeira subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| cabeçalho2 = Segunda subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
<pre style="overflow:auto">
{{Ficha
| título = Título de nível máximo
| cabeçalho1 = Primeira subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 1.1
| dados1 = Dado 1.1
}}
| cabeçalho2 = Segunda subsecção
{{Ficha | descat = sim | filha = sim
| rótulo1 = Rótulo 2.1
| dados1 = Dado 2.1
}}
| abaixo-estilo =
| abaixo = Texto abaixo
}}
</pre>{{clear}}
Note que omitir o parâmetro {{parâmetro|título}}, e não incluir qualquer texto que precede a infocaixa incorporada, pode resultar em fileiras de tabela em branco falsos e criar vãos ma apresentação visual.
== Subcaixas ==
Um método alternativo para incorporar é usar {{parâmetro|subcaixa|{{var|sim}}}}, que remove a borda externa da infocaixa, mas preserva a estrutura interior. Uma função desta abordagem é que as caixas mãe e filha não necessitam de ter a mesma estrutura e os campos rótulo e dados não são alinhados entre as caixas mãe e filha porque não estão na mesma tabela mãe.
{{Ficha
|cabeçalho-estilo = background-color:#eee;
|rótulo-estilo = background-color:#eee;
|cabeçalho1 = Principal 1
|cabeçalho2 = Principal 2
| dados3 = {{Ficha | subcaixa = sim
|cabeçalho-estilo = background-color:#ccc;
|rótulo-estilo = background-color:#ddd;
|cabeçalho1 = Sub 3-1
|cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| dados4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Rótulo 4-1 | dados1 = Dado 4-1
}}
| rótulo5 = Rótulo 5 | dados5 = Dado 5
|cabeçalho6 = Principal 6
}}
<pre style="overflow:auto">
{{Ficha
|cabeçalho-estilo = background-color:#eee;
|rótulo-estilo = background-color:#eee;
|cabeçalho1 = Principal 1
|cabeçalho2 = Principal 2
| dados3 = {{Ficha | subcaixa = sim
|cabeçalho-estilo = background-color:#ccc;
|rótulo-estilo = background-color:#ddd;
|cabeçalho1 = Sub 3-1
|cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| dados4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Rótulo 4-1 | dados1 = Dado 4-1
}}
| rótulo5 = Rótulo 5 | dados5 = Dado 5
|cabeçalho6 = Principal 6
}}
</pre>{{clear}}
Técnicas de incorporação similares podem ser usadas dentro de parâmetros de conteúdo de algumas outras predefinições que geram tabelas (como {{tlg|Sidebar}}) :
{{Sidebar/Testes
| navbar = off
| headingstyle = background-color:#eee;
| heading1 = Cabeçalho 1
| heading2 = Cabeçalho 2
| content3 = {{Ficha | subcaixa = sim
| cabeçalho-estilo = background-color:#ccc;
| rótulo-estilo = background-color:#ddd;
| cabeçalho1 = Sub 3-1
| cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| content4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Label 4-1 | dado1 = Dado 4-1
}}
| heading5 = Cabeçalho 5
}}
<pre style="overflow:auto">
{{Sidebar
| navbar = off
| headingstyle = background-color:#eee;
| heading1 = Cabeçalho 1
| heading2 = Cabeçalho 2
| content3 = {{Ficha | subcaixa = sim
| cabeçalho-estilo = background-color:#ccc;
| rótulo-estilo = background-color:#ddd;
| cabeçalho1 = Sub 3-1
| cabeçalho2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dado 3-3
}}
| content4 = {{Ficha | subcaixa = sim
| rótulo-estilo = background-color:#ccc;
| rótulo1 = Label 4-1 | dado1 = Dado 4-1
}}
| heading5 = Cabeçalho 5
}}
</pre>{{clear}}
Note que o padding padrão da célula de dado da mãe que contém cada subcaixa ainda está visível, então as subcaixas são um bocadinho mais estreitas que a caixa mãe e há um espaçamento vertical mais alto entre células padrão da caixa mãe do que entre células de subcaixas distintas.
== Controlar quebra de linha em listas sem bullets incorporadas ==
Predefinição {{tlx|nbsp}} pode ser usada com {{tlx|wbr}} e {{tlx|nowrap}} para controlar quebra de linha em listas sem bullets incorporadas em infocaixas (ex. lista de elenco), para prevenir entradas longas e envoltas de ser confundidas com múltiplas entradas.
== Sintaxe em branco completa ==
(Nota: não há limite de número de fileiras possíveis, mas somente 20 são exibidas abaixo. Apenas aumente a numeração o quanto necessário. Os parâmetros "class" de microformatos também são omitidos, visto que não são comummente usados.)
<pre style="overflow:auto">
{{Ficha
| nome = {{subst:PAGENAME}}
| filha = {{{filha|}}}
| subcaixa = {{{subcaixa|}}}
| título itálico = {{{título itálico|não}}}
| corpo-estilo =
| título-estilo =
| acima-estilo =
| subcabeçalho-estilo =
| título =
| acima =
| subcabeçalho =
| imagem-estilo =
| legenda-estilo =
| imagem =
| legenda =
| imagem2 =
| legenda2 =
| cabeçalho-estilo =
| rótulo-estilo =
| dados-estilo =
| cabeçalho1 =
| rótulo1 =
| dados1 =
| cabeçalho2 =
| rótulo2 =
| dados2 =
| cabeçalho3 =
| rótulo3 =
| dados3 =
| cabeçalho4 =
| rótulo4 =
| dados4 =
| cabeçalho5 =
| rótulo5 =
| dados5 =
| cabeçalho6 =
| rótulo6 =
| dados6 =
| cabeçalho7 =
| rótulo7 =
| dados7 =
| cabeçalho8 =
| rótulo8 =
| dados8 =
| cabeçalho9 =
| rótulo9 =
| dados9 =
| cabeçalho10 =
| rótulo10 =
| dados10 =
| cabeçalho11 =
| rótulo11 =
| dados11 =
| cabeçalho12 =
| rótulo12 =
| dados12 =
| cabeçalho13 =
| rótulo13 =
| dados13 =
| cabeçalho14 =
| rótulo14 =
| dados14 =
| cabeçalho15 =
| rótulo15 =
| dados15 =
| cabeçalho16 =
| rótulo16 =
| dados16 =
| cabeçalho17 =
| rótulo17 =
| dados17 =
| cabeçalho18 =
| rótulo18 =
| dados18 =
| cabeçalho19 =
| rótulo19 =
| dados19 =
| cabeçalho20 =
| rótulo20 =
| dados20 =
| abaixo-estilo =
| abaixo =
}}
</pre>{{clear}}