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

{{subpágina de documentação}}<includeonly>
<!-- {{Fusão com|Módulo:Navbox|data=setembro de 2015}}-->
{{Fusão|Predefinição:Navbox subgroup|data=julho de 2014}}
{{alto-risco| 355000 }}
{{nomobile}}
</includeonly>
{{lua|Módulo:Navbox|Módulo:Navbar}}

Esta predefinição facilita a criação de caixas de navegação, com ligações a artigos relacionados. É altamente recomendável usá-la para garantir a padronização, facilidade de uso e manutenção. Para caixas de navegação de artistas musicais utilize a {{LP|Navbox artista musical}}.

==Uso==
Por favor remova os parâmetros que ficarem em branco.
<pre>
{{Navbox
|nome    = {{subst:PAGENAME}}
|classe  = hlist
|estado  = {{{estado|}}}

|título  = 
|acima   = 
|imagem  = 

|grupo1  = 
|lista1  = 

|grupo2  = 
|lista2  = 
 ...
|grupo30 = 
|lista30 = 

|abaixo  = 
}}
</pre>

== Lista de parâmetros ==
{{Navbox
| nome    = Navbox/doc
| classe  = hlist
| estado  = uncollapsed
| título  = {{{título}}}
| acima   = *{{{acima}}}
| imagem  = {{{imagem}}}
| grupo1  = {{{grupo1}}}
| lista1  = *{{{lista1}}}
| grupo2  = {{{grupo2}}}
| lista2  = *{{{lista2}}}
| lista3  = *{{{lista3}}} ''sem {{{grupo3}}}''
| grupo4  = {{{grupo4}}}
| lista4  = *{{{lista4}}}
| abaixo  = *{{{abaixo}}}
}}

Note que apenas ''nome'' e ''título'' são obrigatórios.

Os parâmetros básicos e mais comuns são os seguintes:

: <code>nome – </code>apenas relevante na exibição de ligações na barra de título <code>(v • e)</code> para ver e editar a predefinição.
: <code>título – </code>o texto da barra de título.
: <code>classe-lista – </code>uma classe [[Cascading Style Sheets|CSS]] para as células das listas, geralmente <code>hlist</code> para criar listas horizontais. Alternativamente, use o parâmetro <code>classe</code> para aplicar uma classe à caixa inteira.

: <code>grupo<sub>n</sub> – </code>o texto que aparece à esquerda da lista-n (se o grupo-n for omitido, a lista-n começa no lado esquerdo da caixa).
: <code>lista<sub>n</sub> – </code>lista de ligações internas definida em código wiki.

: <code>estado – </code>controla quando o conteúdo da caixa de navegação estará expandido ou oculto; valores possíveis:
:*<code>uncollapsed</code> — aberta
:*<code>collapsed</code> — fechada
:*<code>autocollapse</code> — valor usado por omissão; abre ou fecha conforme o conteúdo imediatamente antes ou depois

: <code>estilo-título – </code>um estilo CSS para a barra de título
: <code>estilo-grupo – </code>um estilo CSS para as células dos grupos
: <code>estilo-ímpares – </code>um estilo CSS específico para as listas ímpares
: <code>estilo-pares – </code>um estilo CSS específico para as listas pares

: <code>acima – </code>texto a ser colocado acima da seção do grupo/lista
: <code>abaixo – </code>texto a ser exibido abaixo da seção do grupo/lista.

: <code>imagem – </code>uma imagem (opcional) a ser exibida no lado direito, codificada como a imagem completa. Tipicamente ela é puramente decorativa, codificada como <code><nowiki>[[Imagem:</nowiki><var>XX</var><nowiki>.jpg|80px|link=|alt=]]</nowiki></code> (se a licença da imagem não exigir indicação dos autores).
: <code>imagem-esquerda – </code>uma imagem a ser exibida no lado esquerdo (codificada da mesma forma do parâmetro "|imagem"), no entanto só será exibida se não houverem sido preenchidos os parâmetros de grupo (grupo1, grupo2, grupo3...).

===Exemplo de formatação===
<pre>
|estilo-título = background: #FFF;
|estilo-grupo  = background: #FFF;                         
|estilo-acima  = text-align: center; background: #FFF;     
|estilo-abaixo = text-align: center; background: #FFF;
|estilo-lista  = background: #FFF;
</pre>

==Subgrupos==
Para inserir uma caixa de navegação dentro de outra, use <code><nowiki>{{Navbox|subgrupo}}</nowiki></code> dentro da caixa de navegação.

===Exemplo===
<pre>{{Navbox
| nome    = 
| classe  = hlist
| estado  = 
| título  = 
| acima   = 
| imagem  = 
| grupo1  = 
| lista1  = 
| grupo2  = 
| lista2  = {{Navbox|subgrupo
  |grupo1 = 
  |lista1 = 
  |grupo2 = 
  |lista2 = 
  }}
| lista3  = 
| grupo4  = 
| lista4  = 
| abaixo  = 
}}</pre>

{{Navbox
| nome    = Navbox/doc
| classe  = hlist
| estado  = uncollapsed
| título  = {{{título}}}
| acima   = *{{{acima}}}
| imagem  = {{{imagem}}}
| grupo1  = {{{grupo1}}}
| lista1  = *{{{lista1}}}
| grupo2  = {{{grupo2}}}
| lista2  = {{Navbox|subgrupo
  |grupo1 = {{{subgrupo1}}}
  |lista1 = *{{{lista1}}}
  |grupo2 = {{{subgrupo2}}}
  |lista2 = *{{{lista2}}}
  }}
| lista3  = *{{{lista3}}} ''sem {{{grupo3}}}''
| grupo4  = {{{grupo4}}}
| lista4  = *{{{lista4}}}
| abaixo  = *{{{abaixo}}}
}}

{{Documentação dos parâmetros}}

== Ver também ==
* [[Predefinição:Barra de navegação]]
* [[Predefinição:Barra de navegação1]]
* [[Predefinição:Navboxes]] - Compacta várias caixas de navegação para artigos que contenham muitas delas
* [[Predefinição:Navbox subgroup]] - Predefinição obsoleta para inserir uma caixa de navegação dentro de outra
* [[Predefinição:Navbox com grupos anexos]] - Produz uma caixa de navegação que permite a visualização ou a omissão de cada grupo.
* [[Predefinição:Navbox árvore de categorias]]

{{Modelo de navegação}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|Testes||

[[Categoria:!Predefinições para caixas de navegação| ]]
[[Categoria:!Excluir ao imprimir]]
}}</includeonly>