Questo template consente di visualizzare un template di navigazione in maniera uniforme e relativamente semplice e rapida.

Caratteristiche

modifica

Il Navbox genera una tabella con le seguenti classi:

  • navbox - definita in Modulo:Navbox/styles.css, imposta l'aspetto grafico standard.
  • mw-collapsible - la tabella è un "cassetto" a scomparsa; di default è inizialmente aperto se è l'unico navbox della pagina o inizialmente chiuso se ce ne sono altri. Per cambiare la condizione iniziale vedi il parametro state sotto.
  • noprint - il navbox sparisce nella stampa, come è giusto che sia per ogni template di navigazione.
  • metadata - il navbox è etichettato come contenuto non enciclopedico e in particolare sparisce nella versione mobile.

Inoltre, normalmente contiene sempre una {{Tnavbar}} mini.

Nella pagina del template stesso (namespace Template) appare automaticamente anche {{Controllo inclusione}} per verificare i link e le inclusioni del template.

La sintassi deve essere copiata nella pagina del template che si vuole creare. Per favore, rimuovi i parametri non compilati.

Sintassi semplice

modifica
{{Navbox
| name    = {{subst:PAGENAME}}
| state   = <!-- "collapsed" se si vuole che il template sia chiuso all'inizio -->
| title   = 

| group1  = 
| list1   = 

| group2  = 
| list2   = 

...

| group20 = 
| list20  = 
}}

Sintassi completa

modifica
{{Navbox
| name       = {{subst:PAGENAME}}
| navbar     = 
| state      = 
| titlestyle = 
| title      = 
| image      = 
| bodystyle  = <!-- (o "style =" se non sono stati utilizzati altri parametri di stile -->
| groupstyle = 
| liststyle  = 
| oddstyle   = 
| evenstyle  = 
| fontelink  = 

| abovestyle = 
| above      = 

| group1     = 
| list1      = 

| group2     = 
| list2      = 

 ...

| group20    = 
| list20     = 

| belowstyle = 
| below      = 
}}

Parametri

modifica

Obbligatori

modifica
name
Il nome del template che si vuole creare, necessario perché funzionino i link "v · d · m" ("vedi · discuti · modifica") in tutte le pagine dove il template è usato. Con {{subst:PAGENAME}} il parametro si compila automaticamente.
title
È il testo che appare al centro della barra del titolo del template. Indica usualmente l'argomento del template, ad esempio una didascalica descrizione di ciò che contiene il corpo del template. Dovrebbe essere di una sola riga, ma se è necessaria una seconda riga, si può utilizzare {{-}} in modo tale da inserire centralmente anche questa seconda riga.
Il colore di sfondo di default è #ccf (forma abbreviata di #ccccff), ma può essere cambiato usando il parametro titlestyle (vedi sotto).
listn
(ad esempio list1, list2 ecc.) Questi parametri riempiono il corpo del template, che usualmente sarà una lista di wikilink. Per dividere gli elementi della lista si consiglia di usare {{,}}, il quale genera uno spazio e un punto (Tizio · Caio). Se si dovessero usare altri separatori, per motivi tecnici bisogna evitare di andare a capo oppure racchiudere la lista in un <div>...</div>.
È obbligatorio compilare almeno un parametro list; ogni list addizionale viene visualizzato in una riga separata della tabella. Ogni listn è preceduto dal corrispondente parametro groupn, se fornito, che funge da etichetta per tutta la lista. L'allineamento della lista è di default al centro se isolata, a sinistra se accompagnata dal relativo groupn.
Di default, il background delle righe è alternato per facilitare la lettura: la prima riga (corrispondente a list1) avrà lo sfondo bianco; la seconda riga (corrispondente a list2) avrà lo sfondo #f9f9f9; la terza riga sarà di nuovo bianca e così via.

Opzionali

modifica
groupn
(ad esempio group1, group2 ecc.) Se specificati, il testo appare in una cella alla sinistra del relativo listn. Se non specificati, listn occupa l'intera larghezza della tabella.
Se è specificato solo groupn senza listn, il gruppo diventa un titolo di sezione e occupa l'intera larghezza della tabella.
Il colore di sfondo di default è #ddf (forma abbreviata di #ddddff), ma può essere cambiato usando il parametro groupstyle (vedi sotto).
image
Un'immagine viene visualizzata in una cella al di sotto del titolo e alla destra della parte di tabella che comprende i groups/lists. Affinché l'immagine sia visualizzata correttamente, il parametro list1 deve essere specificato. Il parametro image accetta il normale markup delle immagini di Wikipedia, ad esempio
[[Immagine:Esempio.jpg|100px]]
In un template dove la parte groups e/o list non occupa la tabella fino in fondo a destra, l'immagine risulterà spostata verso sinistra. Questo può essere evitato specificando right nel markup dell'immagine, ad esempio
[[Immagine:Esempio.jpg|80px|right]]
above
Una cella larga come tutta la tabella verrà visualizzata tra la barra del titolo e il primo group/list, in pratica sopra la parte di tabella occupata da group, list e image. In un template senza immagine, above svolge la stessa funzione del parametro list1 senza il relativo parametro group1.
below
Una cella larga come tutta la tabella verrà visualizzata al di sotto della parte di tabella occupata da group, list e image. In un template senza immagine, below svolge la stessa funzione del parametro listn finale.
titlestyle
Gli stili CSS da applicare al parametro title, usualmente per cambiare il colore di sfondo:
titlestyle = background:#nnnnnn;
titlestyle = background:nome del colore;
bodystyle o style
Specifica gli stili CSS da applicare al corpo del template. Il nome breve style può essere usato quando nessun altro parametro di stile è stato specificato. Questa opzione dovrebbe essere usata con cautela perché potrebbe causare problemi di visualizzazione. Esempi:
background:#nnnnnn;
width:N [em/%/px];
float:[left/right/none];
clear:[right/left/both/none];
groupstyle
Stili CSS da applicare a tutte le celle groupN. Esempi:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
groupnstyle
Stili CSS da applicare ad una singola cella groupN. Esempi:
background:#nnnnnn;
color:#nnnnnn;
liststyle
Stili CSS da applicare a tutte le celle listN. Esempi:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
listnstyle
Stili CSS da applicare ad una singola cella listN. Esempi:
background:#nnnnnn;
color:#nnnnnn;
oddstyle
evenstyle
Stili CSS da applicare a singole celle di liste dispari (oddstyle) (list1, list3 ecc.) o pari (evenstyle) (list2, list4 ecc). Di default, viene applicato un colore di sfondo alternato bianco/grigio tra le varie liste per rendere più facile la consultazione.
abovestyle
belowstyle
Stili CSS da applicare a celle opzionali al di sopra o al di sotto della tabella (vedi parametri above e below). Tipicamente si utilizza per cambiare allineamento del testo o colore di sfondo:
background:#nnnnnn;
text-align:[left/center/right];
Stili alternativi
modifica

Gli stili seguenti sono quelli che chi utilizza il navbox cambia più spesso.

titlestyle = background:#ccccff;
bodystyle = background:white; width:100%; vertical-align:middle;
groupstyle = background:#ddddff; text-align:center;
liststyle = background:transparent; text-align:center;
oddstyle = background:transparent;
evenstyle = background:#f7f7f7;
abovestyle = background:#ddddff; text-align:center;
belowstyle = background:#ddddff; text-align:center;
state
Il default è autocollapse. Un navbox con autocollapse inizierà chiuso solo se c'è almeno un altro navbox nella stessa pagina (o altri template che usano la class collapsible). Altrimenti, al momento dell'apertura della pagina il navbox verrà visualizzato aperto.
Se si inserisce collapsed, inizierà sempre chiuso, eccetto che nella pagina di descrizione del template.
Se si inserisce un altro valore qualunque, diverso da "collapsed" e "autocollapse" (che è già il default), inizierà sempre aperto.
navbar
Ha un unico valore accettato: plain, che disabilita la visualizzazione della Tnavbar, ossia i link "v · d · m" posti sulla sinistra della barra del titolo.
fontelink
Eventuale indirizzo a un sito esterno attendibile, per verificare che l'insieme dei link utilizzato dal navbox sia completo. Per esempio per verificare la rosa di una società sportiva. Genererà il link "Fonte per l'aggiornamento" sotto al "Controllo inclusione del template" e anch'esso visibile solo nel namespace Template.

Disposizione

modifica

{{Navbox}} senza immagine e senza i parametri above e below (i bordi sono presenti solo a fini illustrativi):

{{Navbox}} con immagine, con una sezione e con i parametri above e below (i bordi sono presenti solo a fini illustrativi):

Senza gruppi, senza immagine

modifica
{{Navbox
| name    = {{subst:PAGENAME}}
| state   =
| title   = [[Tematiche]]
| list1   = [[Equipaggiamento]]{{·}}[[Trovare alloggio]]{{·}}[[Documenti]]{{·}}[[Quando andare]]
}}

Questo template di navigazione è autochiudente: nelle voci appare inizialmente chiuso solo se sono presenti anche altri template cassettabili. Questo è il comportamento di default se non si compila il parametro state del Template:Navbox.

Senza gruppi, senza immagine, altro stile

modifica
{{Navbox
| name       = {{subst:PAGENAME}}
| state      = collapsed
| title      = [[Tematiche]]
| titlestyle = background:#ffc0cb;
| liststyle  = font-size:95%;
| list1      = [[Equipaggiamento]]{{·}}[[Trovare alloggio]]{{·}}[[Documenti]]{{·}}[[Quando andare]]
}}

Questo template di navigazione appare inizialmente chiuso nelle voci perché generato da un Template:Navbox con valore collapsed inserito nel parametro state. Solo in questa pagina il template appare di default aperto per facilitarne la consultazione.

Con gruppi, senza immagine

modifica
{{Navbox
| name       = {{subst:PAGENAME}}
| state      =
| title      = [[Tematiche]]
| group1     = [[Template:Tematiche turistiche/Prima di partire|Prima di partire]]
| list1      = [[Equipaggiamento]]{{·}}[[Trovare alloggio]]{{·}}[[Documenti]]{{·}}[[Quando andare]]
| group2     = [[Template:Tematiche turistiche/In viaggio con|In viaggio con…]]
| list2      = [[Viaggiare in aereo]]{{·}}[[Viaggiare in auto]]{{·}}[[Viaggiare in treno]]{{·}}[[Viaggiare in autobus]]{{·}}[[Viaggiare in barca]]
| group3     = [[Template:Tematiche turistiche/Durante il viaggio|Durante il viaggio]]
| list3      = [[Fotografia di viaggio]]{{·}}[[Mangiare e bere]]{{·}}[[Igiene e cura del corpo]]{{·}}[[Sicurezza]]
| group4     = [[Template:Tematiche turistiche/Eventi|Eventi]]
| list4      = [[Eventi|Eventi per mese]]{{·}}[[Mercatini di Natale]]{{·}}[[Eventi musicali]]
| group5     = [[Template:Tematiche turistiche/Nazioni del mondo|Nazioni del mondo]]
| list5      = [[Nazioni dalla A alla Z]]{{·}}[[Lista di stati per superficie]]{{·}}[[Lista di sigle nazionali]]{{·}}[[Unione europea]]
}}

Questo template di navigazione è autochiudente: nelle voci appare inizialmente chiuso solo se sono presenti anche altri template cassettabili. Questo è il comportamento di default se non si compila il parametro state del Template:Navbox.

Con gruppi, con immagine, con sezione

modifica
{{Navbox
| name       = {{subst:PAGENAME}}
| state      =
| title      = [[Tematiche]]
| image      = [[File:World globe vector illustration.svg|58px|right]]
| group1     = [[Template:Tematiche turistiche/Prima di partire|Prima di partire]]
| list1      = [[Equipaggiamento]]{{·}}[[Trovare alloggio]]{{·}}[[Documenti]]{{·}}[[Quando andare]]
| group2     = [[Template:Tematiche turistiche/In viaggio con|In viaggio con…]]
| list2      = [[Viaggiare in aereo]]{{·}}[[Viaggiare in auto]]{{·}}[[Viaggiare in treno]]{{·}}[[Viaggiare in autobus]]{{·}}[[Viaggiare in barca]]
| group3     = [[Template:Tematiche turistiche/Durante il viaggio|Durante il viaggio]]
| list3      = [[Fotografia di viaggio]]{{·}}[[Mangiare e bere]]{{·}}[[Igiene e cura del corpo]]{{·}}[[Sicurezza]]
| group4     = [[Template:Tematiche turistiche/Eventi|Eventi]]
| list4      = [[Eventi|Eventi per mese]]{{·}}[[Mercatini di Natale]]{{·}}[[Eventi musicali]]
| group5     = [[Template:Tematiche turistiche/Nazioni del mondo|Nazioni del mondo]]
| list5      = [[Nazioni dalla A alla Z]]{{·}}[[Lista di stati per superficie]]{{·}}[[Lista di sigle nazionali]]{{·}}[[Unione europea]]
| group6     = [[Template:Tematiche turistiche/Stili di vita|Stili di vita in viaggio]]
| list6      = [[Viaggiare con i bambini]]{{·}}[[Nudisti e naturisti]]
}}

Questo template di navigazione è autochiudente: nelle voci appare inizialmente chiuso solo se sono presenti anche altri template cassettabili. Questo è il comportamento di default se non si compila il parametro state del Template:Navbox.

Con gruppi, con immagine, altro stile

modifica
{{Navbox
| name       = {{subst:PAGENAME}}
| state      = collapsed
| title      = [[Tematiche]]
| titlestyle = background:#ffc0cb; color:inherit;
| image      = [[File:World globe vector illustration.svg|58px|right]]
| groupstyle = background:#FFE0E0; color:inherit; text-align:right;
| liststyle  = text-align:left;
| group1     = [[Template:Tematiche turistiche/Prima di partire|Prima di partire]]
| list1      = [[Equipaggiamento]]{{·}}[[Trovare alloggio]]{{·}}[[Documenti]]{{·}}[[Quando andare]]
| group2     = [[Template:Tematiche turistiche/In viaggio con|In viaggio con…]]
| list2      = [[Viaggiare in aereo]]{{·}}[[Viaggiare in auto]]{{·}}[[Viaggiare in treno]]{{·}}[[Viaggiare in autobus]]{{·}}[[Viaggiare in barca]]
| group3     = [[Template:Tematiche turistiche/Durante il viaggio|Durante il viaggio]]
| list3      = [[Fotografia di viaggio]]{{·}}[[Mangiare e bere]]{{·}}[[Igiene e cura del corpo]]{{·}}[[Sicurezza]]
| group4     = [[Template:Tematiche turistiche/Eventi|Eventi]]
| list4      = [[Eventi|Eventi per mese]]{{·}}[[Mercatini di Natale]]{{·}}[[Eventi musicali]]
| group5     = [[Template:Tematiche turistiche/Nazioni del mondo|Nazioni del mondo]]
| list5      = [[Nazioni dalla A alla Z]]{{·}}[[Lista di stati per superficie]]{{·}}[[Lista di sigle nazionali]]{{·}}[[Unione europea]]
| group6     = [[Template:Tematiche turistiche/Stili di vita|Stili di vita in viaggio]]
| list6      = [[Viaggiare con i bambini]]{{·}}[[Nudisti e naturisti]]
| group7     = [[Template:Tematiche turistiche/Destinazioni a tema|Destinazioni a tema]]
| list7      = [[Attrazioni naturali]]{{·}}[[Vita all'aperto]]{{·}}[[Attrazioni culturali]]{{·}}[[Attività ricreative]]{{·}}[[Cicloturismo]]{{·}}[[Turismo religioso]]{{·}}[[Storia europea]]{{·}}[[Patrimoni mondiali dell'umanità]]{{·}}[[I borghi più belli d'Italia]]{{·}}[[Bandiera arancione]]
| group8     = Altro
| list8      = [[Frasari]]{{·}}[[Itinerari]]{{·}}[[Ultime notizie]]
}}

Questo template di navigazione appare inizialmente chiuso nelle voci perché generato da un Template:Navbox con valore collapsed inserito nel parametro state. Solo in questa pagina il template appare di default aperto per facilitarne la consultazione.

Con gruppi, con immagine nella barra del titolo

modifica
{{Navbox
| name       = {{subst:PAGENAME}}
| state      =
| title      = [[File:Flag of Canada.svg|22px]] Province e territori del [[Canada]]
| group1     = Province
| list1      = [[Alberta]]{{,}}[[Columbia Britannica]]{{,}}[[Isola del Principe Edoardo]]{{,}}[[Manitoba]]{{,}}[[New Brunswick]]{{,}}[[Nuova Scozia]]{{,}}[[Ontario]]{{,}}[[Québec (provincia)|Québec]]{{,}}[[Saskatchewan]]{{,}}[[Terranova]]{{,}}[[Labrador (regione)|Labrador]]
| group2     = Territori
| list2      = [[Nunavut]]{{,}}[[Territori del Nord-Ovest]]{{,}}[[Yukon]]
}}

Questo template di navigazione è autochiudente: nelle voci appare inizialmente chiuso solo se sono presenti anche altri template cassettabili. Questo è il comportamento di default se non si compila il parametro state del Template:Navbox.

Pagine correlate

modifica