Predefinição:Infocaixa
| Esta predefinição é usada em aproximadamente 517 000 páginas. (Ver Wikipedia:Predefinições em alto risco) Para evitar sobrecargas desnecessárias ao servidor e outros transtornos, quaisquer mudanças devem ser previamente testadas, seja na subpágina de testes desta predefinição ou em sua subpágina da predefinição de testes (ou ainda em sua subpágina de testes). Por favor, sempre considere expor eventuais mudanças na página de discussão, antes de implementá-las. |
| Esta predefinição usa Lua: |
| {{{título}}} | |
|---|---|
| {{{subtítulo}}} | |
| {{{subtítulo2}}} ...... | |
| {{{imagem}}} {{{legenda}}} | |
| {{{imagem2}}} {{{legenda2}}} ...... | |
{{{tópico1}}} ( ou ) | |
| {{{rótulo1}}} | {{{dados1}}} |
| ( ou ) {{{dados1}}} | |
| {{{tópico2}}} ( ou ) | |
| {{{rótulo2}}} | {{{dados2}}} |
| ( ou ) {{{dados2}}} | |
( etc ) | |
| {{{rodapé}}} | |
Predefinição:Infocaixa foi criada como uma meta-predefinição: uma predefinição usada para construir outras predefinições. Observação: Em geral, não se destina ao uso direto em um artigo, mas pode ser usado apenas uma vez, se necessário. Ajuda:Infocaixa contém uma introdução sobre o conteúdo e o design recomendado para infocaixas; Consulte WP:Lista de infocaixas e Categoria:!Predefinições de caixas de informação para listas de infocaixas preparadas e específicas para cada tópico.
Uso
{{Infocaixa}} é uma meta-predefinição: usado para organizar uma predefinição {{Info/algumtópico}} real (como {{Info/Organização}}).
Para [[Predefinição:Info/algumtópico]], o código da predefinição se parece com isso, simplificado:
{{Infocaixa
| nome = {{{nome|{{PAGENAME}}}}}
| imagem = {{{imagem|}}}
| legenda1 = {{{legenda|}}}
| rótulo1 = Nomes anteriores
| dados1 = {{{nomes anteriores|}}}
| tópico2 = informações gerais
| rótulo3 = Estado
| dados3 = {{{estado|}}}
... <!-- etc. -->
}}
Parâmetros de controle opcionais
- nome
- Se este parâmetro estiver presente, links para "ver, discutir e editar" serão adicionados na parte inferior da infocaixa, apontando para a página especificada, prefixada por
Predefinição:se nenhum espaço nominal for especificado. Você pode usar o valor {{subst:PAGENAME}}; no entanto, isso raramente é o desejado, pois fará com que os usuários que clicarem nesses links na infocaixa sejam direcionados para o código da predefinição, em vez dos dados na infocaixa que provavelmente desejam alterar. - child
- Veja a seção Incorporação para mais detalhes. Se este parâmetro for definido como "yes", esta infocaixa filha deverá ter um título, mas não deverá utilizar o parâmetro "name". Este parâmetro é vazio por padrão; defina como "yes" para ativá-lo.
- subbox
- Veja a seção Subcaixas para mais detalhes. Se este parâmetro for definido como "yes", esta subcaixa deverá ter um título, mas não deverá utilizar o parâmetro "nome". Este parâmetro é vazio por padrão; defina como "yes" para ativá-lo. Não tem efeito se o parâmetro
|child=também estiver definido como "yes". - decat
- Se este parâmetro for definido como "yes", a página atual não será automaticamente categorizada em uma categoria de manutenção quando a infocaixa gerada apresentar algum problema ou não possuir uma seção de dados visível. Por padrão, deve permanecer vazio ou ser definido como "yes" para ativá-lo.
- autoheaders
- Se este parâmetro receber qualquer valor não vazio, os tópicos que não forem seguidos por campos de dados serão suprimidos. Veja a seção "ocultar tópicos quando todos os seus campos de dados estiverem vazios" para mais detalhes.
Parâmetros de conteúdo
Título
Existem duas maneiras diferentes de adicionar um título a uma infocaixa. Uma insere o cabeçalho como legenda sobre a borda da infocaixa, e a outra o coloca dentro da célula superior da tabela. É possível usar ambas juntas, apenas uma ou nenhuma (embora não seja recomendado):
- cabeçalho
- Texto que aparece como legenda acima da tabela (ou como cabeçalho de seção antes de todo o conteúdo da tabela, se for uma infocaixa filha).
- título
- Texto que aparece dentro da célula superior da tabela.
- subtítulo(n)
- Campos de títulos adicionais que aparecem abaixo de
|cabeçalho=e|título=, mas antes das imagens.
Exemplos:
| Subtítulo da infocaixa | |
{{Infocaixa
| nome = {{subst:PAGENAME}}
| cabeçalho = Texto na legenda acima da infocaixa
| subtítulo = Subtítulo da infocaixa
| tópico = (o restante da infocaixa vai aqui)
}}
| Texto na célula superior da infocaixa | |
|---|---|
| Subtítulo da infocaixa | |
| Segundo subtítulo da infocaixa | |
{{Infocaixa
| nome = {{subst:PAGENAME}}
| título = Texto na célula superior da infocaixa
| subtítulo = Subtítulo da infocaixa
| subtítulo2 = Segundo subtítulo da infocaixa
| tópico = (o restante da infocaixa vai aqui)
}}
Imagens de ilustração
- imagem(n)
- Imagens a serem exibidas no topo da predefinição. Use a sintaxe completa de imagens, por exemplo: [[Ficheiro:exemplo.png|200px|alt=Texto alternativo de exemplo]]. A imagem é centralizada por padrão. Veja WP:ALT para mais informações sobre texto alternativo.
- legenda(n)
- Texto exibido abaixo da imagem.
Dados principais
- tópico(n)
- Texto a ser usado como tópico na linha n.
- rótulo(n)
- Texto a ser usado como rótulo na linha n.
- dados(n)
- Texto exibido como dado na linha n.
Nota: para um determinado valor de (n), nem todas as combinações de parâmetros são permitidas. A presença de |tópico(n)= faz com que os parâmetros |dados(n)= e |rótulo(n)= (e |classe-linha(n)=, se usado) sejam ignorados. Da mesma forma, a ausência de |dados(n)= faz com que o |rótulo(n)= correspondente também seja ignorado. As combinações válidas para uma única linha são:
|classe(n)=|tópico(n)=|classe-linha(n)=|classe(n)=|dados(n)=|classe-linha(n)=|rótulo(n)=|classe(n)=|dados(n)=
Veja a renderização de tópico4, rótulo4 e dados4 na seção Exemplos abaixo.
Intervalos de numeração
Para facilitar ajustes futuros no layout da infocaixa, é possível usar números não sequenciais nas linhas de tópico e rótulo/dados. Assim, novos parâmetros podem ser inseridos sem precisar renumerar os existentes. Por exemplo:
| tópico3 = Seção 1
| rótulo5 = Rótulo A
| dados5 = Dados A
| rótulo7 = Rótulo C
| dados7 = Dados C
| tópico10 = Seção 2
| rótulo12 = Rótulo D
| dados12 = Dados D
Não há limite máximo para os números, mas deve haver no máximo 50 unidades de diferença entre cada número utilizado.
Tornando campos opcionais
Uma linha com rótulo, mas sem dado, não é exibida. Isso permite criar facilmente linhas opcionais na infocaixa. Para isso, use um parâmetro que tenha valor padrão vazio, assim:
| rótulo5 = População | dados5 = {{{população|}}}
Dessa forma, se um artigo não definir o parâmetro "população" na infocaixa, a linha não será exibida.
Para campos mais complexos, com conteúdos pré-formatados que ainda apareceriam mesmo que o parâmetro não fosse definido, pode-se usar uma expressão "#if" para ocultar tudo caso o parâmetro não seja usado. Por exemplo, a expressão abaixo lê: “Se o parâmetro massa for fornecido, exiba o valor seguido de 'kg'”:
|rótulo6 = Massa
| dados6 = {{ #if: {{{massa|}}} | {{{massa}}} kg }}
Para mais informações sobre "#if", veja aqui.
Ocultar tópicos quando todos os seus dados estiverem vazios
É possível fazer com que os tópicos sejam ocultados automaticamente quando a seção estiver vazia (ou seja, sem nenhuma linha de dados exibida).
Considere o seguinte exemplo:
| Tópico 1 (vazio) | |
|---|---|
| Tópico 5 (com dados) | |
| Rótulo 6 | Algum valor |
{{Infocaixa
| cabeçalho = Exemplo: tópico com e sem dados
| tópico-estilo = background: lightgrey
| tópico1 = Tópico 1 (vazio)
| rótulo2 = Rótulo 2 | dados2 =
| rótulo3 = Rótulo 3 | dados3 =
| rótulo4 = Rótulo 4 | dados4 =
| tópico5 = Tópico 5 (com dados)
| rótulo6 = Rótulo 6 | dados6 = Algum valor
}}
Se você quiser ocultar o tópico quando nenhum valor de |dadosN= estiver presente, use |autoheaders=y:
| Tópico 5 (com dados) | |
|---|---|
| Rótulo 6 | Algum valor |
{{Infocaixa | cabeçalho = Exemplo: tópico com e sem dados | autoheaders = y | tópico-estilo = background: lightgrey
| tópico1 = Tópico 1 (vazio)
| rótulo2 = Rótulo 2 | dados2 =
| rótulo3 = Rótulo 3 | dados3 =
| rótulo4 = Rótulo 4 | dados4 =
| tópico5 = Tópico 5 (com dados)
| rótulo6 = Rótulo 6 | dados6 = Algum valor
}}
Assim, o valor "tópico1" será exibido se qualquer um dos itens (item2, item3 ou item4) estiver definido. Se nenhum deles estiver, o tópico não será mostrado e nenhuma linha vazia será exibida antes do próximo conteúdo visível.
Nota: se o dado tiver elementos CSS vazios, como |data=, isso será tratado como não vazio (ou seja, como se tivesse dados).
Se você usar |autoheaders=y, mas houver itens que não deseja que acionem um tópico, utilize |tópicoX=_BLANK_. Isso funciona como um tópico vazio e separa dos itens seguintes.
| Rótulo 6 | Algum valor, mas não aciona tópico1 nem exibe tópico5 |
|---|
{{Infocaixa | cabeçalho = Exemplo: tópico vazio com e sem dados | autoheaders = y | tópico-estilo = background: lightgrey
| tópico1 = Tópico 1 (vazio)
| rótulo2 = Rótulo 2 | dados2 =
| rótulo3 = Rótulo 3 | dados3 =
| rótulo4 = Rótulo 4 | dados4 =
| tópico5 = _BLANK_
| rótulo6 = Rótulo 6 | dados6 = Algum valor, mas não aciona tópico1 nem exibe tópico5
}}
Rodapé
- rodapé
- Texto exibido na célula inferior. Essa célula é destinada a notas de rodapé, "ver também" e outras informações complementares.
Parâmetros de apresentação
Títulos em itálico
Os títulos dos artigos com infocaixas podem ser colocados em itálico, utilizando o parâmetro título em itálico.
- Ative os títulos em itálico passando
|título em itálico={{{título em itálico|}}}a partir da infocaixa. - Desative por padrão (principalmente porque apenas alfabetos latinos podem ser renderizados de forma segura nesse estilo, já que o itálico pode ser necessário para distinguir palavras em idiomas estrangeiros do idioma local, mas seria difícil de ler em outros sistemas de escrita). Entretanto, permite que algumas instâncias sejam colocadas em itálico passando
|título em itálico={{{título em itálico|no}}}. - Não aplique nenhum título em itálico simplesmente não utilizando esse parâmetro.
Estilo CSS
- estilo
- Aplica-se à tabela da infocaixa como um todo.
- cabeçalho-estilo
- Aplica-se apenas à legenda do título. Adicionar uma cor de fundo geralmente não é recomendado, pois o texto é renderizado "fora" da infocaixa.
- título-estilo
- Aplica-se apenas à célula "título" no topo. O estilo padrão usa
font-size:125%;; como essa célula geralmente é usada para um título, se quiser utilizá-la para texto em tamanho regular, incluafont-size:100%;em título-estilo. - imagem-estilo
- Aplica-se à célula onde está localizada a imagem. Isso inclui o texto da legenda da imagem, mas você deve definir propriedades de texto usando
legenda-estiloem vez deimagem-estilo, caso a legenda seja movida para fora dessa célula no futuro. - legenda-estilo
- Aplica-se ao texto da legenda da imagem.
- linha-estilo(n)
- Este parâmetro é inserido no atributo
estiloda linha especificada. - tópico-estilo
- Aplica-se a todas as células de tópicos.
- subtítulo-estilo
- Aplica-se a todas as células de subtítulos.
- rótulo-estilo
- Aplica-se a todas as células de rótulo.
- dados-estilo
- Aplica-se a todas as células de dados.
- rodapé-estilo
- Aplica-se apenas à célula "rodapé".
Classes HTML e microformatos
- classe
- Este parâmetro é inserido no atributo
classeda infocaixa como um todo. - cabeçalho-classe
- Este parâmetro é inserido no atributo
classeda legenda de título da infocaixa. - título-classe
- Este parâmetro é inserido no atributo
classeda célula título da infocaixa. - subtítulo-classe-linha(n)
- Este parâmetro é inserido no atributo
classeda linha completa onde está o subtítulo especificado. - subtítulo-classe(n)
- Este parâmetro é inserido no atributo
classdo subheader especificado. - imagem-classe-linha(n)
- Estes parâmetros são inseridos no atributo
classeda linha completa onde está a respectiva imagem. - imagem-classe
- Este parâmetro é inserido no atributo
classeda imagem. - classe-linha(n)
- Este parâmetro é inserido no atributo
classeda linha especificada, incluindo as células de rótulo e dados. - classe(n)
- Este parâmetro é inserido no atributo
classeda célula de dados da linha especificada. Caso não haja célula de dados, não terá efeito. - rodapé-classe
- Este parâmetro é inserido no atributo
classeda célula rodapé da infocaixa.
Esta predefinição oferece suporte à adição de informações de microformatos. Isso é feito adicionando atributos classe às várias células de dados, indicando que tipo de informação elas contêm. Podem ser especificados vários nomes de classes, separados por espaços — alguns são usados como seletores para estilos personalizados, conforme políticas do projeto ou preferências de skin dos usuários, e outros são usados para microformatos.
Para marcar uma infocaixa como contendo informações de hCard, por exemplo, adicione o seguinte parâmetro:
| classe = vcard
E, para cada linha contendo uma célula de dados que faz parte do vcard, adicione o parâmetro de classe correspondente:
| classe1 = fn
| classe2 = org
| classe3 = tel
...e assim por diante. As células título e cabeçalho também podem receber classes, já que geralmente são usadas para exibir o nome do sujeito da infocaixa.
Exemplos
Perceba como a linha não aparece na infocaixa exibida quando um rótulo é definido sem uma célula de dados correspondente, e como todas são exibidas quando um tópico é definido na mesma linha que uma célula de dados. Note também que os subtítulos não aparecem em negrito por padrão, ao contrário dos tópicos que são usados para dividir a seção principal de dados, pois essa função está destinada à célula título :
{{Infocaixa
|nome = Infocaixa/doc
|estilo =
|cabeçalho-estilo =
|título-estilo = background: #cfc;
|subtítulo-estilo =
|cabeçalho = Teste de Infocaixa
|título = Texto acima
|subtítulo = Subtítulo acima da imagem
|subtítulo2 = Segundo subtítulo
|imagem-estilo =
|legenda-estilo =
|imagem = [[Ficheiro:Example-serious.jpg|200px|alt=Texto alternativo de exemplo]]
|legenda = Legenda exibida abaixo do Ficheiro:Example-serious.jpg
|tópico-estilo = background: #ccf;
|rótulo-estilo = background: #ddf;
|dados-estilo =
|tópico1 = Tópico definido sozinho
|rótulo1 =
| dados1 =
|tópico2 =
|rótulo2 = Rótulo definido sozinho não é exibido (precisa de dados, ou é suprimido)
| dados2 =
|tópico3 =
|rótulo3 =
| dados3 = Dados definidos sozinhos
|tópico4 = Todos os três definidos (tópico, rótulo, dados, todos com o mesmo número)
|rótulo4 = não é exibido (mesmo número que um tópico)
| dados4 = não é exibido (mesmo número que um tópico)
|tópico5 =
|rótulo5 = Rótulo e dados definidos (rótulo)
| dados5 = Rótulo e dados definidos (dados)
|rodapé-estilo = background: #ddf;
|rodapé = Texto abaixo
}}
Neste exemplo, os parâmetros |estilo= e |rótulo-estilo= são usados para ajustar a largura da infocaixa e definir uma largura padrão para a coluna dos rótulos:
| Teste de Infocaixa | |
|---|---|
| Rótulo 1 | Dados 1 |
| Rótulo 2 | Dados 2 |
| Rótulo 3 | Dados 3 |
| Tópico 4 | |
| Rótulo 5 | Dados 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
| Texto abaixo | |
{{Infocaixa
|nome = Infocaixa/doc
|estilo = width: 20em
|cabeçalho-estilo =
|título = Teste de Infocaixa
|tópico-estilo =
|rótulo-estilo = width: 33%
|dados-estilo =
|tópico1 =
|rótulo1 = Rótulo 1
| dados1 = Dados 1
|tópico2 =
|rótulo2 = Rótulo 2
| dados2 = Dados 2
|tópico3 =
|rótulo3 = Rótulo 3
| dados3 = Dados 3
|tópico4 = Tópico 4
|rótulo4 =
| dados4 =
|tópico5 =
|rótulo5 = Rótulo 5
| dados5 = Dados 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|rodapé-estilo =
|rodapé = Texto abaixo
}}
Incorporação
Uma infocaixa pode ser incorporada dentro de outra usando o parâmetro |child=. Isso pode ser usado para criar uma infocaixa modular ou para definir melhor seções lógicas internas.
| Primeira subseção | |
| Rótulo 1.1 | Dados 1.1 |
|---|---|
| Segunda subseção | |
| Rótulo 2.1 | Dados 2.1 |
| Texto inferior | |
{{Infocaixa
| cabeçalho = Título principal
| dados1 = {{Infocaixa | decat = yes | child = yes
| cabeçalho = Primeira subseção
| rótulo1 = Rótulo 1.1
| dados1 = Dados 1.1
}}
| dados2 = {{Infocaixa | decat = yes | child = yes
| cabeçalho = Segunda subseção
| rótulo1 = Rótulo 2.1
| dados1 = Dados 2.1
}}
| rodapé-estilo =
| rodapé = Texto inferior
}}
Nos exemplos acima, a infocaixa filha está dentro de um campo |dados=, e não em um campo |tópico=. Observe que os títulos das subseções não aparecem em negrito, a menos que a formatação em negrito seja especificada manualmente. Se desejar que os títulos das subseções apareçam em negrito, coloque a infocaixa filha dentro de um campo tópico (mas não dentro de um campo rótulo, pois nesse caso ela não seria exibida).
| Primeira subseção | |
|---|---|
| Rótulo 1.1 | Dados 1.1 |
| Segunda subseção | |
| Rótulo 2.1 | Dados 2.1 |
| Texto inferior | |
{{Infocaixa
| cabeçalho = Título principal
| tópico1 = {{Infocaixa | decat = yes | child = yes
| cabeçalho = Primeira subseção
| rótulo1 = Rótulo 1.1
| dados1 = Dados 1.1
}}
| tópico2 = {{Infocaixa | decat = yes | child = yes
| cabeçalho = Segunda subseção
| rótulo1 = Rótulo 2.1
| dados1 = Dados 2.1
}}
| rodapé-estilo =
| rodapé = Texto inferior
}}
ou,
| Primeira subseção | |
|---|---|
| Rótulo 1.1 | Dados 1.1 |
| Segunda subseção | |
| Rótulo 2.1 | Dados 2.1 |
| Texto inferior | |
{{Infocaixa
| cabeçalho = Título principal
| tópico1 = Primeira subseção
{{Infocaixa | decat = yes | child = yes
| rótulo1 = Rótulo 1.1
| dados1 = Dados 1.1
}}
| tópico2 = Segunda subseção
{{Infocaixa | decat = yes | child = yes
| rótulo1 = Rótulo 2.1
| dados1 = Dados 2.1
}}
| rodapé-estilo =
| rodapé = Texto inferior
}}
Se você omitir o parâmetro |tópico= na infocaixa filha e não incluir nenhum texto antes dela, podem surgir linhas vazias na tabela, criando espaços indesejados na apresentação visual. Para resolver isso, use o parâmetro |linha-estiloN=display: none, substituindo N pelo número da linha correspondente (dadosN ou tópicoN).
Subcaixas
Uma alternativa à incorporação é usar o parâmetro |subbox=yes, que remove a borda externa da infocaixa, mas preserva sua estrutura interna. Uma das características dessa abordagem é que a infocaixa pai e a infocaixa filha não precisam ter a mesma estrutura, e os campos de rótulo e dados não são alinhados entre a caixa principal e a subcaixa, pois elas não estão dentro da mesma tabela.
| Principal 1 | |||||||
|---|---|---|---|---|---|---|---|
| Principal 2 | |||||||
| |||||||
| |||||||
| Rótulo 5 | Dados 5 | ||||||
| Principal 6 | |||||||
{{Infocaixa
| tópico-estilo = background-color: #eee;
| rótulo-estilo = background-color: #eee;
| tópico1 = Principal 1
| tópico2 = Principal 2
| dados3 = {{Infocaixa | subbox = yes
| tópico-estilo = background-color: #ccc;
| rótulo-estilo = background-color: #ddd;
| tópico1 = Sub 3-1
| tópico2 = Sub 3-2
| rótulo3 = Rótulo 3-3 | dados3 = Dados 3-3
}}
| dados4 = {{Infocaixa | subbox = yes
| rótulo-estilo = background-color: #ccc;
| rótulo1 = Rótulo 4-1 | dados1 = Dados 4-1
}}
| rótulo5 = Rótulo 5 | dados5 = Dados 5
| tópico6 = Principal 6
}}
A margem interna (padding) da célula da caixa pai que contém cada subbox ainda é visível. Portanto, as subcaixas ficam ligeiramente mais estreitas que a caixa pai e existe um espaçamento vertical maior entre as células padrão da caixa principal do que entre as células das subcaixas.
Sintaxe completamente em branco
(Observação: não há limite para o número de linhas possíveis; apenas 20 são fornecidas abaixo, pois infocaixas maiores que isso serão relativamente raras. Basta estender a numeração conforme necessário. Os parâmetros de "classe" do microformato também são omitidos, pois não são comumente usados.)
{{Infocaixa
| nome = {{subst:PAGENAME}}
| child = {{{child|}}}
| subbox = {{{subbox|}}}
| título em itálico = {{{título em itálico|no}}}
| templatestyles =
| child templatestyles =
| grandchild templatestyles =
| estilo =
| cabeçalho-estilo =
| título-estilo =
| subtítulo-estilo =
| cabeçalho =
| título =
| subtítulo =
| imagem-estilo =
| legenda-estilo =
| imagem =
| legenda =
| imagem2 =
| legenda2 =
| tópico-estilo =
| rótulo-estilo =
| dados-estilo =
| tópico1 =
| rótulo1 =
| dados1 =
| tópico2 =
| rótulo2 =
| dados2 =
| tópico3 =
| rótulo3 =
| dados3 =
| tópico4 =
| rótulo4 =
| dados4 =
| tópico5 =
| rótulo5 =
| dados5 =
| tópico6 =
| rótulo6 =
| dados6 =
| tópico7 =
| rótulo7 =
| dados7 =
| tópico8 =
| rótulo8 =
| dados8 =
| tópico9 =
| rótulo9 =
| dados9 =
| tópico10 =
| rótulo10 =
| dados10 =
| tópico11 =
| rótulo11 =
| dados11 =
| tópico12 =
| rótulo12 =
| dados12 =
| tópico13 =
| rótulo13 =
| dados13 =
| tópico14 =
| rótulo14 =
| dados14 =
| tópico15 =
| rótulo15 =
| dados15 =
| tópico16 =
| rótulo16 =
| dados16 =
| tópico17 =
| rótulo17 =
| dados17 =
| tópico18 =
| rótulo18 =
| dados18 =
| tópico19 =
| rótulo19 =
| dados19 =
| tópico20 =
| rótulo20 =
| dados20 =
| rodapé-estilo =
| rodapé =
}}
