Predefinição:Navbox

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Esta predefinição é usada em aproximadamente 355 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 não aparece na versão móvel da Wikipédia. Ela é visível apenas em desktop. Leia a documentação para mais informações.

Esta predefinição usa Lua:

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 {{Navbox artista musical}}.

Uso

Por favor remova os parâmetros que ficarem em branco.

{{Navbox
|nome    = {{subst:PAGENAME}}
|classe  = hlist
|estado  = {{{estado|}}}

|título  = 
|acima   = 
|imagem  = 

|grupo1  = 
|lista1  = 

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

|abaixo  = 
}}

Lista de parâmetros

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

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

nome – apenas relevante na exibição de ligações na barra de título (v • e) para ver e editar a predefinição.

título – o texto da barra de título.

classe-lista – uma classe CSS para as células das listas, geralmente hlist para criar listas horizontais. Alternativamente, use o parâmetro classe para aplicar uma classe à caixa inteira.

grupo_n – o texto que aparece à esquerda da lista-n (se o grupo-n for omitido, a lista-n começa no lado esquerdo da caixa).

lista_n – lista de ligações internas definida em código wiki.

estado – controla quando o conteúdo da caixa de navegação estará expandido ou oculto; valores possíveis:

uncollapsed — aberta
collapsed — fechada
autocollapse — valor usado por omissão; abre ou fecha conforme o conteúdo imediatamente antes ou depois

estilo-título – um estilo CSS para a barra de título

estilo-grupo – um estilo CSS para as células dos grupos

estilo-ímpares – um estilo CSS específico para as listas ímpares

estilo-pares – um estilo CSS específico para as listas pares

acima – texto a ser colocado acima da seção do grupo/lista

abaixo – texto a ser exibido abaixo da seção do grupo/lista.

imagem – uma imagem (opcional) a ser exibida no lado direito, codificada como a imagem completa. Tipicamente ela é puramente decorativa, codificada como [[Imagem:XX.jpg|80px|link=|alt=]] (se a licença da imagem não exigir indicação dos autores).

imagem-esquerda – 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

|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;

Subgrupos

Para inserir uma caixa de navegação dentro de outra, use {{Navbox|subgrupo}} dentro da caixa de navegação.

Exemplo

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

Cabeçalho de TemplateData

As informações a seguir (editar) são definidas com TemplateData. Isso possibilita o seu uso pelo Editor Visual e por outras ferramentas.

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 {{Navbox artista musical}}.

Parâmetros da predefinição[Editar dados da predefinição]
Esta predefinição tem formatação personalizada.
Parâmetro		Descrição	Tipo	Estado
nome	`nome` `name`	Apenas relevante na exibição de ligações na barra de título (v • e) para ver e editar a predefinição. Padrão {{subst:PAGENAME}} Valor automático `{{subst:PAGENAME}}`	Conteúdo	obrigatório
classe	`classe` `classe-corpo` `class`	Uma classe CSS para as células das listas, geralmente hlist para criar listas horizontais. Padrão hlist Exemplo hlist, vlist, plainlist Valor automático `hlist`	Linha	obrigatório
estado	`estado` `state`	Controla quando o conteúdo da caixa de navegação estará expandido ou oculto. Padrão autocollapse Exemplo autocollapse, collapsed, uncollapsed Valor automático `autocollapse`	Conteúdo	recomendado
título	`título` `title`	O texto da barra de título. Valor automático	Conteúdo	obrigatório
acima	`acima` `above`	Texto a ser colocado acima da seção do grupo/lista	Conteúdo	opcional
imagem	`imagem` `image`	Uma imagem (opcional) a ser exibida no lado direito, codificada como a imagem completa. Tipicamente ela é puramente decorativa, codificada como [[Imagem:XX.jpg\|80px\|link=\|alt=]] (se a licença da imagem não exigir indicação dos autores).	Conteúdo	opcional
imagem-esquerda	`imagem-esquerda` `imageleft`	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...).	Conteúdo	opcional
grupo1	`grupo1` `group1`	O texto que aparece à esquerda da lista-n (se o grupo-n for omitido, a lista-n começa no lado esquerdo da caixa).	Conteúdo	opcional
lista1	`lista1` `list1`	Lista de ligações internas definida em código wiki. Exemplo * Item da lista	Conteúdo	obrigatório
grupo2	`grupo2` `group2`	sem descrição	Conteúdo	opcional
lista2	`lista2` `list2`	sem descrição	Conteúdo	opcional
grupo3	`grupo3` `group3`	sem descrição	Conteúdo	opcional
lista3	`lista3` `list3`	sem descrição	Conteúdo	opcional
grupo4	`grupo4` `group4`	sem descrição	Conteúdo	opcional
lista4	`lista4` `list4`	sem descrição	Conteúdo	opcional
grupo5	`grupo5` `group5`	sem descrição	Conteúdo	opcional
lista5	`lista5` `list5`	sem descrição	Conteúdo	opcional
grupo6	`grupo6` `group6`	sem descrição	Conteúdo	opcional
lista6	`lista6` `list6`	sem descrição	Conteúdo	opcional
grupo7	`grupo7` `group7`	sem descrição	Conteúdo	opcional
lista7	`lista7` `list7`	sem descrição	Conteúdo	opcional
grupo8	`grupo8` `group8`	sem descrição	Conteúdo	opcional
lista8	`lista8` `list8`	sem descrição	Conteúdo	opcional
grupo9	`grupo9` `group9`	sem descrição	Conteúdo	opcional
lista9	`lista9` `list9`	sem descrição	Conteúdo	opcional
grupo10	`grupo10` `group10`	sem descrição	Conteúdo	opcional
lista10	`lista10` `list10`	sem descrição	Conteúdo	opcional
abaixo	`abaixo` `below`	Texto a ser exibido abaixo da seção do grupo/lista.	Conteúdo	opcional

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 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

Comparação das predefinições de navegação
ver discutir editar	Desmontável	Cor de cabeçalho	Imagem	Grupos	Parâmetro/s de estilo (corpo)	Exemplos
{{Navbox}}	desmontável	navbox	Esquerda/direita do corpo	Sim	Sim	{{Navbox Sistema Solar}}
{{Navbox com grupos anexos}}	desmontável	navbox	Esquerda/direita do corpo e/ou em cada lista	Sim	Sim	{{Universidade de Michigan}}
{{Navbox with columns}}	desmontável	navbox	Esquerda/direita de colunas	Não	Sim	{{Senadores dos EUA}} {{Chéquia}}

Atributos desmontáveis
Tipo	Classes CSS	JavaScript	Desmonta-se quando	Estado inicial personalizado	Aninhamento
Tabelas expansíveis	collapsible	Definido em MediaWiki:Gadget-ElementosOcultaveis.js	2 ou mais autocollapse na página	Sim	Sim

A documentação acima é transcluída de Predefinição:Navbox/doc.
Editores podem experimentar nas páginas de teste e de exemplos para testes desta predefinição.
Adicione categorias à subpágina /doc. Subpáginas desta predefinição.

v d e {{{título}}}
{{{acima}}}
{{{grupo1}}}	{{{lista1}}}	{{{imagem}}}
{{{grupo2}}}	{{{lista2}}}
{{{lista3}}} sem {{{grupo3}}}
{{{grupo4}}}	{{{lista4}}}
{{{abaixo}}}