Exibir código-fonte para Predefinição:Info/doc

<includeonly>{{testes outro||{{Alto risco| 528000 }}}}</includeonly>
{{subpágina de documentação}}
{{Info
|cabeçalho={{{cabeçalho}}}
|título={{{título}}}
|subtítulo={{{subtítulo}}}
|subtítulo2={{{subtítulo2}}}
|imagem=Exemplo.jpg
|imagem-tamanho=255px
|tópico1={{{tópico1}}}
|rótulo1={{{rótulo1}}}
|dados1={{{dados1}}}
|rodapé={{{rodapé}}}
|nome={{{nome|Predefinição:Info}}}
}}
A meta-predefinição '''Info''' é um modelo padrão utilizado para a construção de caixas de informação (''infocaixas'') temáticas. Permite a adaptação para diversos estilos e formatos. Não deve ser utilizada diretamente nos artigos.

=== Uso ===
A informação visualizada pode ser personalizada de maneira similar à {{tl|Navbox}}. Cada linha na tabela pode ser um tópico, um par rótulo/dados, ou ainda apenas uma célula de dados. Estes dados podem ser de qualquer natureza, como textos, imagens, tabelas, ou até mesmo outras predefinições. O formato básico é apresentado logo abaixo, e outros exemplos práticos são mostradas na seção correspondente.

{| style="background-color:transparent; overflow:auto;"
|- style="vertical-align:text-top;"
|Agrupados por função
<pre style="overflow:auto;">
{{Info
<!-- Identificação -->
| cabeçalho          = Cabeçalho externo
| título             = Título externo
| pictograma         = Adiciona uma imagem ao lado do título
| tamanho-pictograma = Altera o tamanho do pictograma
| pictograma-ligação = Adiciona a ligação para o Commons do pictograma
| pictograma-legenda = Adiciona uma legenda ao pictograma
| opacidade          = Opacidade do pictograma
| margem-superior    = Define a distância da margem superior da posição do pictograma
| subtítulo          = Subtítulo opcional
| subtítulo2         = Segundo subtítulo opcional
| imagem             = Imagem principal
| imagem-tamanho     = Largura da imagem
| legenda            = Legenda da imagem 
| imagem1            = Imagem secundária
| imagem_tamanho1    = Largura da imagem secundária
| imagem_legenda1    = Legenda da imagem secundária
| imagem2            = Imagem terciária
| imagem_tamanho2    = Largura da imagem terciária
| imagem_legenda2    = Legenda da imagem terciária
<!--- Estilos CSS --->
| classe             = Classe geral da infocaixa
| estilo             = Estilo geral da infocaixa
| cabeçalho-classe   = Classe do cabeçalho
| cabeçalho-estilo   = Estilo do cabeçalho
| título-classe      = Classe do título
| título-estilo      = Estilo do título
| tópico-estilo      = Estilo de todos os tópicos
| rótulo-estilo      = Estilo de todos os rótulos
| dados-estilo       = Estilo de todos os dados
| rodapé-estilo      = Estilo do rodapé
<!--- Informações --->
| tópico1            = Tópico opcional da linha 1
|   rótulo1          = Rótulo opcional da linha 1
|   dados1           = Informação da linha 1
| tópico2            = Tópico opcional da linha 2
|   rótulo2          = Rótulo opcional da linha 2
|   dados2           = Informação da linha 2
| tópico(n)          = Tópico opcional da linha n
|   rótulo(n)        = Rótulo opcional da linha n
|   dados(n)         = Informação da linha n
| rodapé             = Informação do rodapé
| nome               = Link da barra de navegação 
}}
</pre>
|&nbsp;
|Agrupados por categorias
<pre style="overflow:auto;">
{{Info

<!-- Infocaixa-->
| classe           = Classe geral infocaixa
| estilo           = Estilo geral infocaixa
| imagem           = Imagem principal
| imagem-tamanho   = Largura da imagem
| legenda          = Legenda da imagem
| imagem1          = Imagem secundária
| imagem_tamanho1  = Largura da imagem secundária
| imagem_legenda1  = Legenda da imagem secundária
| imagem2          = Imagem terciária
| imagem_tamanho2  = Largura da imagem terciária
| imagem_legenda2  = Legenda da imagem terciária

<!-- Títulos -->
| cabeçalho        = Cabeçalho externo
| cabeçalho-classe = Classe do cabeçalho
| cabeçalho-estilo = Estilo do cabeçalho

| título           = Título externo
| título-classe    = Classe do título
| título-estilo    = Estilo do título
| subtítulo        = Subtítulo opcional
| subtítulo2       = Segundo subtítulo opcional

<!-- Pictograma -->
| pictograma         = Adiciona uma imagem ao lado do título
| tamanho-pictograma = Altera o tamanho do pictograma
| pictograma-ligação = Adiciona a ligação para o Commons do pictograma
| pictograma-legenda = Adiciona uma legenda ao pictograma
| opacidade          = Opacidade do pictograma
| margem-superior    = Define a distância da margem superior da posição do pictograma

<!--- Informações --->
| tópico-estilo    = Estilo geral tópicos
| tópico(n)        = Tópico opcional linha n
| rótulo-estilo    = Estilo geral rótulos
|   rótulo(n)      = Rótulo opcional linha n
| dados-estilo     = Estilo geral dados
|   dados(n)       = Informação da linha n

| rodapé-estilo    = Estilo do rodapé
| rodapé           = Informação do rodapé
| nome             = Link de navegação 

|latd  = |latm  = |lats  = |latNS  = Valores de latitude
|longd = |longm = |longs = |longEW = Valores de longitude
|coord_sufixo = Sufixo a suar na chamada de {{tl|Coor dms}}

}}</pre>
|}

==== Parâmetros imagem e imagem-tamanho ====
A imagem pode ser indicada de duas formas:
* Usando <code><nowiki>[[Ficheiro:nome do ficheiro da imagem|outros parâmetros]]</nowiki></code>. Nesta situação, imagem-tamanho é ignorado e a largura deve ser indicada em <code><nowiki>[[Ficheiro:...</nowiki></code>.
* Indicando apenas o nome do ficheiro da imagem. Neste caso, é usada imagem-tamanho caso exista (não esquecer do sufixo, tipicamente "px"). Se imagem-tamanho for omissa, é usado "200px".

=== Campos opcionais ===
Uma linha que possua um ''rótulo'' mas nenhum ''dado'' não é mostrada. Desta forma é possível a criação de infocaixas com conteúdo opcional. Para isso, utilize um parâmetro que tenha como padrão (''default'') uma sequência vazia:
<syntaxhighlight lang="moin">
|rótulo5 = População
|dados5  = {{{população|}}}
</syntaxhighlight>
Desta forma, caso o editor não defina ou deixe vazio o parâmetro ''população'', a linha correspondente da infocaixa não será mostrada.

Para campos mais complexos com conteúdo pré-adicionado que deve estar presente ainda que o parâmetro não tenha sido definido, recomenda-se encapsular toda a expressão dentro de uma declaração "#if",  para que todo o conjunto desapareça quando o parâmetro não tiver sido fornecido:
<syntaxhighlight lang="moin">
|rótulo6 = Massa
|dados6  = {{#if:{{{massa|}}} |{{{massa}}} kg|não informado}}
</syntaxhighlight>

Este exemplo significa literalmente: ''se o parâmetro <code>massa</code> foi fornecido, mostre-o, seguido por <code>kg</code>, caso contrário, mostre o texto <code>não informado</code>.'' Mais informações sobre a declaração #if podem ser encontradas no [[mw:Help:Extension:ParserFunctions/pt-br|MediaWiki Help]] {{pt}}.

É possível tornar um ''tópico'' opcional usando o mesmo recurso. Caso seja preciso que ele apareça somente se um ou mais campos de ''dados'' forem preenchidos, pode-se utilizar o seguinte modelo como ponto de partida:
<syntaxhighlight lang="moin" style="overflow:auto;">
{{Info
|título  = Exemplo de tópico opcional
|tópico1  = {{#if:{{{item_um|}}}{{{item_dois|}}}{{{item_três|}}} |Tópico facultativo}}
|rótulo1 = Item um
|dados1  = {{{item_um|}}}
|rótulo2 = Item dois
|dados2  = {{{item_dois|}}}
|rótulo3 = Item três
|dados3  = {{{item_três|}}}
}}
</syntaxhighlight>
O ''tópico1'' será mostrado somente se ''item_um'', ''item_dois'' ou ''item_três'' for definido. Se nenhum deles for fornecido, a tópico não será mostrado.

=== Pictograma ===
Instruções de como utilizar uma imagem como pictograma ao lado do título da infocaixa.
{| class="wikitable"
!Campo !!Descrição !!Exemplo
|-
|<pre>|pictograma=</pre> ||Nome do ficheiro do pictograma ou imagem a ser usada ||Usando a imagem [[:Ficheiro:Picto_infobox_anime_and_manga.png]]<br />
<pre>{{Info 
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|opacidade=0.7}}
</pre><br />
{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|opacidade=0.7}}
|-
|<pre>|tamanho-pictograma=</pre> ||Tamanho do pictograma, por padrão o tamanho é "33x33px" não é necessário incluir o "px" ||<pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43 
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|opacidade=0.7
|margem-superior=-12px}}
|-
|<pre>|pictograma-ligação=</pre> ||Define se a imagem do pictograma mostra a ligação com o [[:c:Página principal|Commons]]. Se não preenchido faz a ligação com o ficheiro. ||'''Sem ligação'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43 
|pictograma-ligação=1 
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|opacidade=0.7
|margem-superior=-12px}}
{{-}}
----
'''Com ligação'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43 
|pictograma-ligação= 
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=
|opacidade=0.7
|margem-superior=-12px}}
|-
|<pre>|pictograma-legenda=</pre> ||Cria uma captação (texto que aparece quando se para o cursor na imagem) para a imagem. Por padrão nenhum. ||<pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43 
|pictograma-ligação= 
|pictograma-legenda= Wikipe Tan 
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=
|pictograma-legenda= Wikipe Tan
|opacidade=0.7
|margem-superior=-12px}}
|-
|<pre>|opacidade=</pre> ||Opacidade da imagem. Por padrão o valor de transparência é "0.4" mas pode se adicionar valores entre 0.1 e 1, sendo 0.1 mais transparente e 1 o padrão da imagem. ||'''Com opacidade em "0.1"'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43 
|pictograma-ligação=1 
|pictograma-legenda= Wikipe Tan 
|opacidade=0.1
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=0.1
|margem-superior=-12px}}
{{-}}
----
'''Com opacidade em "1"'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43 
|pictograma-ligação=1 
|pictograma-legenda= Wikipe Tan 
|opacidade=1
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=1
|margem-superior=-12px}}
|-
|<pre>|margem-superior=</pre> ||Distância da parte superior da caixa de título, por padrão o valor é -10px. Quanto mais negativo o valor mais próximo do topo da caixa o pictograma ficará. Isso serve para quando o titulo da caixa for muito comprido alinhar a imagem do pictograma com o texto||'''Com margem superior em "-30px"'''<br /><pre>{{Info
|título = Exemplo se este texto ficar muito comprido como no do artigo Sukhoi PAK FA
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43 
|pictograma-ligação=1 
|pictograma-legenda= Wikipe Tan 
|opacidade=0.3 
|margem-superior=-30px}}
</pre><br />{{Info
|título = Exemplo se este texto ficar muito comprido como no do artigo [[Sukhoi PAK FA]]
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=0.6
|margem-superior=-30px}}
|}

=== Organização ===
Recomenda-se que as caixas de informação construídas a partir da  metapredefinição {{tl|Info}} utilizem o sistema de subpáginas. Assim, são agrupadas por temas ou áreas do conhecimento, de maneira hierarquica, todas as caixas de informação relacionadas entre si:<br><br>
{{chart/start|style=background-color:transparent;}}
{{chart| |INFO |-|v|-|GRUPO|-|-|-|ITEM | | |INFO='''{{tl|Info}}'''<br><small>&nbsp;Meta-predefinição&nbsp;</small>
|GRUPO=&nbsp;{{tld|Info/'''[[:Categoria:!Predefinições por tema|tema]]'''}}&nbsp;<br><small>Predefinição geral</small>
|ITEM={{tld|Info/tema/'''[[Ojeto|item]]'''}}<br><small>Predefinição específica</small>}}
{{chart| | | | | |!| | | | | | | | | | | | }}
{{chart| | | | | |)|-|GRUP1|-|v|-|ITEM1| | |GRUP1={{tld|Info/tema'''''A'''''}}
|ITEM1=&nbsp;{{tld|Info/tema'''''A'''''/item'''''1'''''}}&nbsp;}}
{{chart| | | | | |!| | | | | |!| | | | | | }}
{{chart| | | | | |!| | | | | |)|-|ITEM2| | |ITEM2={{tld|Info/tema'''''A'''''/item'''''2'''''}}}}
{{chart| | | | | |!| | | | | |!| | | | | | }}
{{chart|boxstyle=border-style: dotted;| | | | | |!| | | | | |L|~|ITEM3| | |ITEM3={{tld|Info/tema'''''A'''''/item'''''N'''''}}}}
{{chart| | | | | |!| | | | | | | | | | | | }}
{{chart| | | | | |)|-|GRUP2|-|V| | | | | | |GRUP2={{tld|Info/tema'''''B'''''}}}}
{{chart| | | | | |!| | | | | | | | | | | | }}
{{chart|boxstyle=border-style: dotted;| | | | | |D|~|GRUP3| | | | | | | | |GRUP3={{tld|Info/tema'''''X'''''}}}}
{{chart| | | | | | | | | | | | | | | | | | }}
{{chart/end}}
Esta abordagem, além de promover a uniformidade da nomenclatura das predefinições, facilita a navegação e a consulta, por parte do editor, de todas as caixas de informação disponíveis sobre um determinado assunto.

=== Exemplos ===
{{Info
| estilo           = width: 18em;
| cabeçalho        = Cabeçalho (externo)
| título           = Título (interno)
| imagem           = example.png
| imagem-tamanho   = 50px
| legenda          = ''Legenda da imagem''
| tópico-estilo    = background-color:#F4BF92;
| dados1           = ''Texto sem rótulo e sem tópico''
| tópico2          = Tópico definido
| dados2           = ''Texto sem rótulo''
| tópico3          = Tópico definido
| rótulo3          = '''Rótulo definido'''
| dados3           = ''Texto com rótulo''
| rodapé           = Informação mostrada no rodapé
}}
<pre style="overflow:auto;">
{{Info
| estilo           = width: 18em; 
| cabeçalho        = Cabeçalho (externo)
| título           = Título (interno)
| imagem           = example.png
| imagem-tamanho   = 50px
| legenda          = ''Legenda da imagem''
| tópico-estilo    = background-color:#F4BF92;
| dados1           = ''Texto sem rótulo e sem tópico''
| tópico2          = Tópico definido
| dados2           = ''Texto sem rótulo''
| tópico3          = Tópico definido
| rótulo3          = '''Rótulo definido'''
| dados3           = ''Texto com rótulo''
| rodapé           = Informação mostrada no rodapé
}}
</pre>

== Sintaxe ==
{| class="sortable wikitable" style="margin:auto"
! parâmetro
! opcional
! descrição
|-
| '''classe'''
| {{tab-sim}}
| Tem infobox_v2 por valor padrão.
|-
| '''espaço_entre_células'''
| {{tab-sim}}
| Obsoleto (corresponde ao antigo atributo "cellspacing" que é inválido em [[HTML5]])
|-
| '''espaço_conteúdo-borda_das_células'''
| {{tab-sim}}
| Obsoleto (corresponde  ao antigo atributo "cellpadding" que é inválido em HTML5)
|-
| '''largura-borda'''
| {{tab-sim}}
|
|-
| '''estilo'''
| {{tab-sim}}
| Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em [[b:Edição de tabelas wiki]].
|-
| '''largura'''
| {{tab-sim}}
|
|-
| '''cabeçalho'''
| {{tab-sim}}
|
|-
| '''cabeçalho-classe'''
| {{tab-sim}}
|
|-
| '''cabeçalho-estilo'''
| {{tab-sim}}
| Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em [[b:Edição de tabelas wiki]].
|-
| '''título'''
| {{tab-sim}}
|
|-
| '''título-classe'''
| {{tab-sim}}
| Ver as opções disponíveis para o campo em {{tl|Info/topo}}.
|-
| '''título-estilo'''
| {{tab-sim}}
|
|-
| '''hCard'''
| {{tab-sim}}
|
|-
| '''subtítulo'''
| {{tab-sim}}
|
|-
| '''subtítulo-estilo'''
| {{tab-sim}}
|
|-
| '''ocultarsubtítulo'''
| {{tab-sim}}
|
|-
| '''subtítulo-classe'''
| {{tab-sim}}
|
|-
| '''subtítulo2'''
| {{tab-sim}}
|
|-
| '''subtítulo2-estilo'''
| {{tab-sim}}
|
|-
| '''ocultarsubtítulo2'''
| {{tab-sim}}
|
|-
| '''subtítulo2-classe'''
| {{tab-sim}}
|
|-
| '''imagem'''
| {{tab-sim}}
|
|-
| '''imagem-estilo'''
| {{tab-sim}}
|
|-
| '''imagem-tamanho'''
| {{tab-sim}}
|
|-
| '''legenda'''
| {{tab-sim}}
|
|-
| '''legenda-estilo'''
| {{tab-sim}}
|
|-
| '''tópico-estilo'''
| {{tab-sim}}
|
|-
| '''rótulo-estilo'''
| {{tab-sim}}
|
|-
| '''dados-estilo'''
| {{tab-sim}}
|
|-
| '''classe-linhaX'''
| {{tab-sim}}
|
|-
| '''ocultarX'''
| {{tab-sim}}
|
|-
| '''tópicoX'''
| {{tab-sim}}
| X pode ser preenchido com um número até 229.
|-
| '''tópicoX-estilo'''
| {{tab-sim}}
|
|-
| '''dadosX'''
| {{tab-sim}}
| X pode ser preenchido com um número até 229.
|-
| '''dadosX-estilo'''
| {{tab-sim}}
|
|-
| '''rótuloX'''
| {{tab-sim}}
| X pode ser preenchido com um número até 229.
|-
| '''rótuloX-estilo'''
| {{tab-sim}}
|
|-
| '''rodapé'''
| {{tab-sim}}
|
|-
| '''rodapé-estilo'''
| {{tab-sim}}
|
|-
| '''nome'''
| {{tab-sim}}
|
|-
| '''nome-estilo'''
| {{tab-sim}}
|
|-
| '''noedit'''
| {{tab-sim}}
|
|-
| '''latd''', '''latm''', '''lats''', '''latNS''', '''longd''', '''longm''', '''longs''', '''longEW''' e '''coord_sufixo'''
| {{tab-sim}}
| Coloca as coordenadas no canto superior direito da página com {{tl|Coor dms}}; o coord_sufixo determina o sufixo enviado para aquela predef; se for omitido é usado type:landmark. Se latd não for indicado, todos os outros são ignorados.
|-
|}

<includeonly>
{{testes outro||
[[Categoria:!Predefinições para caixas de informação| ]]
}}
</includeonly>