![]() | Utiliza os módulos: |
![]() | Este modelo emprégase en máis de 27 000 páxinas. Para evitar problemas en moitas páxinas e carga innecesaria nos servidores, calquera cambio neste modelo debería probarse primeiro na súa sub-páxina de /probas e seguidamente engadirse na páxina principal nunha soa edición. |
Este modelo permite crear caixas de navegación de forma relativamente sinxela usando unha ou máis listas de ligazóns. Os estilos por defecto deberían ser suficientes para a mioría de caixas de navegación. Estes estilos poden cambiarse, pero non está recomendado. O uso deste modelo e dos seus derivados está recomendado para estandarizar os modelos de navegación e para un uso máis doado destes.
Os Navboxes e outros modelos que usan os atributos navbox
ou vertical-navbox
non se visualizan no Sitio Móbil da Wikipedia.
Suprime os parámetros que vaian quedar en branco:
((Navbox | name = ((subst:PAGENAME)) | title = | listclass = hlist | state = (({state|))} | above = | image = | group1 = | list1 = | group2 = | list2 = <!-- ... --> | group20 = | list20 = | below = ))
O navbox usa parámetros en minúscula, como se pode ver na caixa de enriba. Os parámetros requiridos |name=
e |title=
crean unha caixa dunha soa liña en caso de omitirse o resto de parámetros.
Os parámetros |groupX=
e as seccións |above=
e |below=
son opcionais.
Os parámetros básicos máis comúns son os listados a continuación. Para unha lista completa de parámetros vexa as seguintes seccións.
name
– nome do modelo.title
– texto da barra de título.listclass
– clase CSS para as celas de listas, habitualmente hlist
para as listas horizontais. Tamén se pode usar bodyclass para aplicar un estilo á caixa completa.state
– controla cando se amosa o navbox expandido ou colapsado.titlestyle
– estilo CSS para a barra de título.groupstyle
– estilo CSS para as celas de grupos.above
– texto opcional que aparece na sección "above".image
– imaxe opcional, amosada á dereita da caixa. Debe indicarse co código completo: [[Ficheiro:XX.jpg|XXpx|link=|alt=]]
.imageleft
– imaxe opcional, amosada á esquerda da caixa.groupn
– Texto do grupo "n".listn
– Texto da lista "n".below
– texto opcional que aparece na sección "below".A seguinte é unha lista completa dos parámetros deste modelo. Na maioría dos casos, os parámetros requiridos son só name
, title
, e list1
, aínda que os navboxes fillos non precisan destes.
Este modelo comparte moitos parámetros comúns cos modelos irmáns ((Navbox con columnas)) e ((Navbox with collapsible groups)). Os parámetros marcados con un asterisco (*) son comúns a todos estes modelos.
((subst:PAGENAME))
. Este parámetro só é obrigatorio cando se especifica o parámetro title
e se o parámetro border
non está definido e se o parámetro navbar
non se usa para deshabilitar a barra de navegación.autocollapse, collapsed, expanded, plain, off
]autocollapse
. Un navbox con autocollapse
visualízase de inicio colapsado se hai dúas ou máis táboas na mesma páxina que usen táboas colapsables. De non ser así, o navbox visualízase expandido de inicio. Este comportamento defínese en MediaWiki:Common.js.collapsed
fai que o navbox sempre comece no estado colapsado.expanded
fai que o navbox sempre comece no estado expandido.plain
fai que o navbox sempre estea expandido sen o botón [agochar] na dereita, e o título mantense centrado.off
fai que o navbox sempre estea expandido sen o botón [agochar] na dereita, pero non se centra o título.plain
, as ligazóns V • C • E da esquerda do título non se amosan, e o título mantense centrado. Pode usarse off
para eliminar as ligazóns V • C • E sen centrar o título.child
ou subgroup
pode usarse o navbox como un fillo sen bordo que se inclúe dentro doutro navbox. O bordo agóchase e non se aplica marxes nos lados da táboa, para que se visualice ben na área list correspondente do navbox pai. Co valor none
o bordo agóchase e elimínanse as marxes, para poder empregar o navbox como fillo doutro contedor. (non se debe usar o valor none
dentro doutro navbox, e o valor child
/subgroup
só debe usarse dentro doutro navbox). Con calquera outro valor fai que se visualice un navbox estándar cun bordo de 1px. Para especificar o estilo de grupo fillo pódese empregar da forma:
((Navbox|child
...
))
hlist
as entradas da lista deben indicarse separadas con saltos de liña e asteriscos (*). Cando se usan dous asteriscos (**) a entrada aníñase coa anterior, amosándose entre chaves. Engadindo máis asteriscos tamén incrementa o número de chaves ó redor da entrada.[[Ficheiro:XX.jpg|80px|link=|alt=]]
Polo xeral non se recomenda o uso de estilos para manter a consistencia entre modelos e páxinas. Porén, existe esta opción que se pode aplicar de diversas formas segundo se indica a continuación.
bodystyle = background: #nnnnnn;
bodystyle = width: N [em/%/px or width: auto];
bodystyle = float: [left/right/none];
bodystyle = clear: [right/left/both/none];
basestyle = background: lightskyblue;
titlestyle = background: #nnnnnn;
titlestyle = background: name;
titlestyle = background: none;
— sen cor de fondogroupstyle = background: #nnnnnn;
groupstyle = text-align: [left/center/right];
groupstyle = vertical-align: [top/middle/bottom];
group3style = background: red; color: white;
groupwidth = 9em
list5style = background: #ddddff;
listpadding = 0.5em 0;
(sets 0.5em padding for the left/right, and 0 padding for the top/bottom.)listpadding = 0;
(removes all list padding.)[swap, even, odd, off]
swap
invirte as cores das filas por defecto. Co valor even
ou odd
iguala tódalas filas á cor correspondente. Co valor off
deshabilita as cores automáticas para as filas. Recoméndase o seu uso só para arranxar problemas cando o navbox se usa como fillo doutro.abovestyle = background: #nnnnnn;
abovestyle = text-align: [left/center/right];
belowstyle = background: #nnnnnn;
belowstyle = text-align: [left/center/right];
imagestyle = width:5em;
Os valores por defecto para a maioría de estilos do modelo defínense en MediaWiki:Common.css.
bodystyle = background: #fdfdfd; width: 100%; vertical-align: middle;
titlestyle = background: #ccccff; padding-left: 1em; padding-right: 1em; text-align: center;
abovestyle = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: center;
belowstyle = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: center;
groupstyle = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: right;
liststyle = background: transparent; text-align: left/center;
oddstyle = background: transparent;
evenstyle = background: #f7f7f7;
Xa que liststyle e oddstyle son transparente, as filas impares teñen a cor de bodystyle, por defecto #fdfdfd. Por defecto as listas teñen o valor de aliñamento á esquerda text-align: left;
se ten un grupo, se non o valor por defecto é text-align: center;
. Só bodystyle ten un valor para vertical-align, polo que o resto herda vertical-align: middle;
.
hlist
para que os elementos da lista se visualicen en horizontal. Todos estes parámetros aceptan a clase hlist
, pero de usarse para máis dun deles debería indicarse só en |bodyclass=hlist
.É posible engadir información de microformatos. Isto faise engadindo atributos "class" as celas de datos, indicando que tipo de información conteñen. Por exemplo, para indicar que un navbox contén información dunha persoa hCard:
| bodyclass = vcard
e
| titleclass = fn
ou (por exemplo):
| title = Obras de <span class="fn">[[Iain Banks]]</span>
Táboa xerada por ((Navbox)) sen os parámetros image, above e below (cor de fondo gris das listas engadidas por motivos ilustrativos):
Táboa xerada por ((Navbox)) incluíndo os parámetros image, above e below (cor de fondo gris das listas engadidas por motivos ilustrativos):
Táboa xerada por ((Navbox)) con image, imageleft, lists, e sen groups, above, below (cor de fondo gris das listas engadidas por motivos ilustrativos):
((Navbox | name = ((PAGENAME)) | title = [[Multimedia Super Corridor|MSC Malaysia]] | listclass = hlist | group1 = Centro | list1 = * [[Cyberjaya]] | group2 = Área | list2 = * [[Klang Valley]] | group3 = Lugares principais | list3 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] * [[Kuala Lumpur Sentral]] * [[Technology Park Malaysia]] * [[Putrajaya]] * [[Cyberjaya]] * [[Kuala Lumpur International Airport]] | group4 = Infraestrutura | list4 = * [[Express Rail Link]] * [[KL-KLIA Dedicated Expressway]] | group5 = Aplicacións principais | list5 = * [[EGovernment]] * [[MyKad]] ))
((Navbox | name = ((PAGENAME)) | title = [[Multimedia Super Corridor|MSC Malaysia]] | listclass = hlist | image = [[Ficheiro:Flag of Malaysia.svg|80px|link=|alt=Malaisia]] | list1 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] * [[Kuala Lumpur Sentral]] * [[Technology Park Malaysia]] * [[Putrajaya]] * [[Cyberjaya]] * [[Kuala Lumpur International Airport]] ))
((Navbox | name = ((PAGENAME)) | title = [[Multimedia Super Corridor|MSC Malaysia]] | listclass = hlist | image = [[File:Flag of Malaysia.svg|80px|link=|alt=Malaisia]] | imageleft = [[File:Flag of Malaysia.svg|80px]] | list1 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] * [[Kuala Lumpur Sentral]] | list2 = * [[Express Rail Link]] * [[KL-KLIA Dedicated Expressway]] | list3 = * [[EGovernment]] * [[MyKad]] | list4 = * [[Klang Valley]] ))
((Navbox | name = ((PAGENAME)) | title = [[Multimedia Super Corridor|MSC Malaysia]] | listclass = hlist | above = O texto "above" vai aquí | image = [[File:Flag of Malaysia.svg|80px|link=|alt=Malaisia]] | group1 = Centro | list1 = * [[Cyberjaya]] | group2 = Área | list2 = * [[Klang Valley]] | group3 = Lugares principais | list3 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] * [[Kuala Lumpur Sentral]] * [[Technology Park Malaysia]] * [[Putrajaya]] * [[Cyberjaya]] | group4 = Infraestrutura | list4 = * [[Express Rail Link]] * [[KL-KLIA Dedicated Expressway]] | group5 = Aplicacións principais | list5 = * [[EGovernment]] * [[MyKad]] | below = O texto "below" vai aquí ))
É posible incluír navboxes múltiples dentro dun bordo único co uso do parámetro border, ou especificando no primeiro parámetro o valor "child". O código básico para isto é:
((Navbox | name = ((subst:PAGENAME)) | title = Título | group1 = [opcional] | list1 = ((Navbox|child ...parámetros do navbox fillo... )) ... ))
Recoméndase o uso de ((Navbox subgroup)), pero pode acadarse o mesmo resultado usando ((Navbox)) co parámetro border = child
ou co primeiro parámetro sen nome co valor child
.
((Navbox | name = ((PAGENAME)) | image = [[Ficheiro:Flag of Galicia.svg|100px|link=|alt=Galicia]] | state = uncollapsed | title = Exemplo de subgrupos múltiples | above = Above | below = Below | group1 = Group1 | list1 = List1 | group2 = Group2 | list2 = ((Navbox|child | evenodd = swap | group1 = Group2.1 | list1 = List1 | group2 = Group2.2 | list2 = List2 | group3 = Group2.3 | list3 = List3 )) | group3 = Group3 | list3 = List3 | group4 = Group4 | list4 = ((Navbox|child | evenodd = swap | group1 = Group4.1 | list1 = List1 | group2 = Group4.2 | list2 = List2 | group3 = Group4.3 | list3 = List3 )) ))
((Navbox | name = ((PAGENAME)) | title = [[Ficheiro:Blason France moderne.svg|x17px|link=|alt=]] [[Ficheiro:Flag of France.svg|x17px|link=|alt=]] [[Imperio colonial francés]] | state = uncollapsed | list1 = ((Navbox|child | navbar = plain | title = [[Imperio colonial francés|Antigas colonias]] en [[África]] e o [[Océano Índico]] | listclass = hlist | group1 = [[Magreb]] | list1 = * [[Alxeria]] * [[Marrocos]] <small>([[Arguin]])</small> * [[Historia de Tunisia|Tunisia]] | group2 = [[África occidental francesa]] | list2 = * [[Historia de Costa de Marfil|Costa de Marfil]] * [[Dahomey]] * [[Sudán francés]] * [[Guinea]] * [[Historia de Mauritania|Mauritania]] * [[Historia de Níxer|Níxer]] * [[Historia de Senegal|Senegal]] * [[Alto Volta]] * [[Togolandia]] * [[Illa James]] | group3 = [[África ecuatorial francesa]] | list3 = * [[Chad]] * [[Historia de Gabón|Gabón]] * [[Historia da República do Congo|Congo]] * [[Oubangui-Chari]] | group4 = [[Comoros]] | list4 = * [[Anjouan]] * [[Grande Comore]] * [[Mohéli]] * [[Historia de Xibutí|Xibutí]] * [[Historia de Madagascar|Madagascar]] * [[Mauricio|Ile de France]] * [[Seychelles]] )) | list2 = ((Navbox|child | navbar = plain | title = [[Imperio colonial francés|Antigas colonias]] en [[América]] | listclass = hlist | list1 = * [[Nova Francia ]]((espazos|2))<small>([[Acadia]], [[Louisiana]], [[Canadá]], [[Terra Nova]]) 1655–1763 </small> | list2 = * [[Inini]] * [[Berbice]] * [[Santo Domingo]] * <small>[[Haití]]</small> * [[Tobago]] * [[Historia das Illas Virxes Británicas|Illas Virxes]] * [[Francia antártica]] | below = [[Compañía francesa das Indias occidentais]] )) | list3 = ((Navbox|child | navbar = plain | title = [[Imperio colonial francés|Antigas colonias]] en [[Asia]] e [[Oceanía]] | listclass = hlist | group1 = [[India francesa]] | list1 = * [[Chandernagor]] * [[Coromandel Coast]] * [[Historia de Chennai|Madras]] * [[Mahé]] * [[Historia de Pondichéry|Pondichéry]] * [[Karaikal]] * [[Yanaon]] | group2 = [[Indochina francesa]] | list2 = * [[Cambodxa]] * [[Historia de Laos|Laos]] * [[Vietnam]] <small>([[Annam]], [[Cochinchina]], [[Tonkin]])</small> | group3 = Outros territorios | list3 = * [[Alaouites]] * [[Alexandretta-Hatay]] * [[Sri Lanka]] * [[Kwangchowan]] | group4 = [[Oceanía]] | list4 = * [[Novas Hebrides]] ** [[Vanuatu]] | below = [[Compañía francesa das Indias orientais]] )) ))
Este modelo pode traballar conxuntamente con outros dos modelos: ((Navbox con columnas)) and ((Navbox with collapsible sections)). Os tres modelos comparten parámetros comúns para manter unha consistencia e facilitar o seu uso. Cada un deles pode empregarse como navbox fillo de outro co parámetro |border=child
Por exemplo: ((Navbox|child ...))
, ((Navbox con columnas|child ...))
ou ((Navbox with collapsible sections|child ...))
.)
hlist
para o formato das listas.