Template:Navbox

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

Caratteristiche

Il Navbox genera una tabella con le seguenti classi:

• navbox - definita in MediaWiki:Common.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.
• nowraplinks - i wikilink contenuti non vanno a capo se possibile, ad es. Mario Rossi non andrà mai a capo dopo "Mario".
• 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.

Uso

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

Sintassi semplice

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

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

Obbligatori

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

list_n

(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 list_n è preceduto dal corrispondente parametro group_n, 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 group_n.

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

Celle

group_n

(ad esempio group1, group2 ecc.) Se specificati, il testo appare in una cella alla sinistra del relativo list_n. Se non specificati, list_n occupa l'intera larghezza della tabella.

Se è specificato solo group_n senza list_n, 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, 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 list_n finale.

Stili

titlestyle

Gli stili CSS (Cascading Style Sheets) 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;

group_nstyle

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;

list_nstyle

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

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;

Altri

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

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