Template:Infobox

Da Wikipedia, l'enciclopedia libera.
Avviso importante! Questo template ha un codice sorgente piuttosto complesso e può richiedere buona conoscenza delle funzioni parser.

Per favore, tenta di modificarlo solo se sei certo di capirne la funzione e sei preparato a riparare ogni conseguente danno collaterale nel caso in cui i risultati fossero diversi da quanto avevi in mente. Tutti gli esperimenti devono essere prima condotti in una pagina di prova.

Questa pagina è protetta
Template protetto – Le modifiche possono essere proposte nella pagina di discussione.
Questa pagina è protetta dallo spostamento
Info Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:Infobox/man (modifica·cronologia)

Infobox è un template che facilita la creazione di template sinottici (o infobox) posti sulla destra di una voce. Essendo un sottotemplate, ovvero un template utilizzato per definirne degli altri, non deve essere incluso direttamente nelle voci.

Ogni riga della tabella può essere utilizzata come titolo per un sottogruppo di informazioni oppure direttamente come insieme di celle assegnate ad un campo. Queste due funzioni non possono essere svolte contemporaneamente: se una riga viene definita sia come titolo sia come campo essa verrà assegnata al titolo.

L'utilizzo esclusivo del Valore di un campo permette di inserire caselle estese su due colonne, come per esempio immagini.

Sintassi tipica

{{Infobox
|TitoloInt       = 
|StileTitoloInt  = background-color:
|Immagine        = 
|Didascalia      = 
|StileGruppo     = background-color:

|Gruppo1  = 
|Nome1    = 
|Valore1  = 
|Gruppo2  = 
|Nome2    = 
|Valore2  = 
|Gruppo3  = 
|Nome3    = 
|Valore3  = 
|Gruppo4  = 
|Nome4    = 
|Valore4  = 
|Gruppo5  = 
|Nome5    = 
|Valore5  = 
|Gruppo6  = 
|Nome6    = 
|Valore6  = 
|Gruppo7  = 
|Nome7    = 
|Valore7  = 
|Gruppo8  = 
|Nome8    = 
|Valore8  = 
|Gruppo9  = 
|Nome9    = 
|Valore9  = 
|Gruppo10 = 
|Nome10   = 
|Valore10 = 
|Gruppo11 = 
|Nome11   = 
|Valore11 = 
|Gruppo12 = 
|Nome12   = 
|Valore12 = 
|Gruppo13 = 
|Nome13   = 
|Valore13 = 
|Gruppo14 = 
|Nome14   = 
|Valore14 = 
|Gruppo15 = 
|Nome15   = 
|Valore15 = 
|Gruppo16 = 
|Nome16   = 
|Valore16 = 
|Gruppo17 = 
|Nome17   = 
|Valore17 = 
|Gruppo18 = 
|Nome18   = 
|Valore18 = 
|Gruppo19 = 
|Nome19   = 
|Valore19 = 
|Gruppo20 = 
|Nome20   = 
|Valore20 = 

|Ultima      = 
|StileUltima = background-color:
}}

Sintassi completa

Il template permette l'utilizzo di un numero illimitato di righe per i campi. Di seguito ne sono inclusi solo 20, il che dovrebbe soddisfare la maggior parte degli utilizzatori. In caso contrario basta proseguire sistematicamente con la numerazione.)

{{Infobox
|NomeTemplate    = {{subst:PAGENAME}}
|StileTabella    = 
|TitoloEst       = 
|StileTitoloEst  = 
|TitoloInt       = 
|StileTitoloInt  = 
|Immagine        = 
|StileImmagine   = 
|Didascalia      = 
|StileDidascalia = 
|StileGruppo     = 
|StileNome       = 
|StileValore     = 

|Gruppo1  = 
|Nome1    = 
|Valore1  = 
|Gruppo2  = 
|Nome2    = 
|Valore2  = 
|Gruppo3  = 
|Nome3    = 
|Valore3  = 
|Gruppo4  = 
|Nome4    = 
|Valore4  = 
|Gruppo5  = 
|Nome5    = 
|Valore5  = 
|Gruppo6  = 
|Nome6    = 
|Valore6  = 
|Gruppo7  = 
|Nome7    = 
|Valore7  = 
|Gruppo8  = 
|Nome8    = 
|Valore8  = 
|Gruppo9  = 
|Nome9    = 
|Valore9  = 
|Gruppo10 = 
|Nome10   = 
|Valore10 = 
|Gruppo11 = 
|Nome11   = 
|Valore11 = 
|Gruppo12 = 
|Nome12   = 
|Valore12 = 
|Gruppo13 = 
|Nome13   = 
|Valore13 = 
|Gruppo14 = 
|Nome14   = 
|Valore14 = 
|Gruppo15 = 
|Nome15   = 
|Valore15 = 
|Gruppo16 = 
|Nome16   = 
|Valore16 = 
|Gruppo17 = 
|Nome17   = 
|Valore17 = 
|Gruppo18 = 
|Nome18   = 
|Valore18 = 
|Gruppo19 = 
|Nome19   = 
|Valore19 = 
|Gruppo20 = 
|Nome20   = 
|Valore20 = 

|Ultima      = 
|StileUltima =
}}

Parametri

Link vedi/discuti/modifica

NomeTemplate 
La pagina del template verso la quale devono puntare i link vedi/discuti/modifica. Si può utilizzare {{subst:PAGENAME}}. Se questo parametro è omesso i link non vengono mostrati.

Titolo

Utilizzo di TitoloEst
(L'infobox si trova sotto il titolo)
Utilizzo di TitoloInt
(Il titolo appare all'interno dell'infobox)

Il titolo di un infobox può venire visualizzato in due modi differenti. Il primo lo colloca al di sopra della tabella, il secondo nella prima riga della stessa. Benché sia possibile utilizzare entrambi allo stesso tempo questo è sconsigliato per motivi di chiarezza. Nel namespace principale di norma si utilizza TitoloInt.

TitoloEst 
Il titolo viene mostrato sopra la tabella.
TitoloInt 
Il titolo viene mostrato in cima alla tabella.

Contenuto

Immagine 
un'immagine che viene posta dopo il titolo. Utilizzare una sintassi completa, per esempio [[File:example.png|270x300px|descrizione]]. L'immagine è centrata per default.
Didascalia 
il testo da mettere sotto l'immagine.
GruppoN 
il testo da utilizzare come titolo per un sottogruppo di informazioni (sezione) da porre nella riga N.
GruppoOpzionaleN
alternativo a GruppoN, viene visualizzato solo se viene valorizzata almeno una riga ValoreN prima che compaia un altro Gruppo o GruppoOpzionale.
NomeN
breve descrizione (etichetta) dell'informazione posta nella riga N.
ValoreN
il dato posto nella riga N. Se NomeN non è presente, occuperà l'intera riga.
Ultima
il contenuto dell'ultima riga (piede). Di solito viene utilizzata per note, riferimenti o altre informazioni dello stesso tipo.

Stili in linea (facoltativi)

L'aspetto di ogni parte del sinottico può essere modificato tramite dei comandi CSS. Nel namespace principale di norma questo va fatto solo per assegnare eventuali colori ai titoli; salvo particolari necessità, i sinottici dovrebbero aderire agli standard grafici di it.wiki, che vengono applicati in automatico da Infobox.

StileTabella 
Influenza la tabella nel suo complesso.
StileTitoloEst 
Influenza il titolo se posto all'esterno. L'utilizzo di un colore di sfondo ("background-color") è sconsigliato.
StileTitoloInt 
Influenza la prima riga. Spesso si assegna un colore ("background-color" per lo sfondo, "color" per il primo piano). I caratteri sono più grandi del normale e non occorre ingrandirli; se si tratta di un titolo di opera potrebbe essere utile applicare il corsivo ("font-style:italic").
StileImmagine 
Influenza la cella che contiene l'immagine. Questo include anche l'aspetto della didascalia, ma per motivi di compatibilità è opportuno modificare quest'ultima con "StileDidascalia".
StileDidascalia 
Influenza l'aspetto della didascalia dell'immagine.
StileGruppo 
Influenza le celle contenenti i titoli dei sottogruppi. Spesso si assegna un colore ("background-color" per lo sfondo, "color" per il primo piano).
StileNome 
Influenza le celle con le descrizioni dei campi.
StileValore 
Influenza le celle con le effettive informazioni.
StileUltima 
Influenza l'ultima riga. Spesso si assegna un colore ("background-color" per lo sfondo, "color" per il primo piano).

Classi alternative (facoltativo)

È possibile impostare l'uso di classi CSS alternative definite in MediaWiki:Common.css. Nel namespace principale di norma questo non va fatto; salvo particolari necessità, i sinottici dovrebbero aderire agli standard grafici di it.wiki (classe "sinottico" e accessorie), che vengono applicati in automatico da Infobox.

ClasseTabella
Questo parametro viene assegnato in blocco all'attributo "class" della tabella.
ClasseTitoloEst
Questo parametro viene assegnato in blocco all'attributo "class" di un eventuale titolo all'esterno della tabella.
ClasseTitoloInt
Questo parametro viene assegnato in blocco all'attributo "class" di un eventuale titolo all'interno della tabella.
ClasseImmagine
Questo parametro viene assegnato in blocco all'attributo "class" dell'immagine.
ClasseN
Questo parametro viene assegnato in blocco all'attributo "class" della riga N. Se questa non esiste non ha nessun effetto.

Campi facoltativi

Un campo per il quale la corrispondente variabile ValoreN non è definita non viene visualizzato, indipendentemente dalla presenza o meno di NomeN. Questo permette la definizione di contenuto facoltativo per il sinottico. Basta assegnare per default una stringa vuota ad un parametro, per esempio:

|Nome5 = Popolazione
|Valore5  = {{{Popolazione|}}}

In questo modo se nella voce il parametro {{{Popolazione}}} non viene definito l'intera riga scompare.

Campi più complessi possono essere quelli che modificano i valori dei parametri se definiti ma scompaiono se non utilizzati. Per esempio se il parametro {{{Massa}}} ha un valore, ad esso viene automaticamente aggiunta l'unità di misura. In caso contrario l'intera riga viene omessa.

|Nome6 = Massa
|Valore6  = {{#if:{{{Massa|}}} | {{{Massa}}} kg}}

Allo stesso modo i titoli dei sottogruppi possono venir visualizzati solo se necessario:

{{Infobox
|NomeTemplate = {{subst:PAGENAME}}
|TitoloEst    = Esempio di sottogruppo facoltativo
|Gruppo1      = {{#if:{{{Campo1|}}}{{{Campo2|}}}{{{Campo3|}}} | Sottogruppo facoltativo}}
|Nome2        = Campo 1
|Valore2      = {{{Campo1|}}}
|Nome3        = Campo 2
|Valore3      = {{{Campo2|}}}
|Nome4        = Campo 3
|Valore4      = {{{Campo3|}}}
}}

"Gruppo 1" verrà visualizzato soltanto se uno o più dei campi sottostanti sarà definito.

Esempi

Test infobox
Immagine esempio
Didascalia per example.png
Solo titolo sottogruppo definito
Solo valore del campo definito
Tutti e tre definiti (Gruppo)
Tutti e tre definiti (Gruppo)
Nome e valore campo definiti (Nome) Nome e valore campo definiti (Valore)
Testo ultima riga
{{Infobox
|NomeTemplate    = Infobox/man
|StileTabella    = 
|TitoloInt       = Test ''infobox''
|StileTitoloInt  = background:#ccf;
|Immagine        = [[File:example.png|200px|Immagine esempio]]
|StileImmagine   = 
|Didascalia      = Didascalia per example.png
|StileDidascalia = 
|StileGruppo     = background:#ccf;
|StileNome       = background:#ddf;
|StileValore     = 

|Gruppo1         = Solo titolo sottogruppo definito
|Nome1           = 
|Valore1         = 
|Gruppo2         = 
|Nome2           = Solo nome campo definito
|Valore2         = 
|Gruppo3         =
|Nome3           = 
|Valore3         = Solo valore del campo definito
|Gruppo4         = Tutti e tre definiti (Gruppo)
|Nome4           = Tutti e tre definiti (Nome)
|Valore4         = Tutti e tre definiti (Valore)
|Gruppo5         =
|Nome5           = Nome e valore campo definiti (Nome)
|Valore5         = Nome e valore campo definiti (Valore)

|Ultima          = Testo ultima riga
|StileUltima     = background:#ddf;
}}

Da notare che quando NomeN è definito ma il corrispondente ValoreN no l'intera riga non viene visualizzata. Inoltre il titolo del sottogruppo ha la precedenza sul campo per la stessa riga.

In quest'altro esempio vengono forzate alcune dimensioni: "StileTabella = width:20em;" e "StileNome = width:33%;"

Test infobox
Nome 1 Valore 1
Nome 2 Valore 2
Nome 3 Valore 3
Gruppo 4
Nome 5 Valore 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Testo ultima riga
template Progetto Template: collabora a Wikipedia sull'argomento template