Wikivoyage

Template:Navbox

Info Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:Navbox/man (modifica · cronologia)
Sandbox: Template:Navbox/Sandbox (modifica · cronologia) · Styles: Template:Navbox/styles.css (modifica · cronologia) · Tutte le sottopagine: lista

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

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

Celle

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.

Stili

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

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

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

Esempi

Senza gruppi, senza immagine

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

Senza gruppi, senza immagine, altro stile

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

Con gruppi, senza immagine

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

Con gruppi, con immagine, con sezione

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

Con gruppi, con immagine, altro stile

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

Con gruppi, con immagine nella barra del titolo

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

Pagine correlate

Estratto da "https://it.wikivoyage.org/w/index.php?title=Template:Navbox&oldid=726128"