Predefinição:Navbox/doc

Esta é uma subpágina de documentação para a Predefinição:Navbox.
Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte da predefinição original.

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
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 com colunas}}	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

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