Template:Infobox

Questo template ha un codice sorgente piuttosto complesso.

---

La sua modifica 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.

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

Non usare direttamente questo template nelle voci dato che serve per la creazione di sinottici. Per creare una tabella vedi Aiuto:Tabelle.

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.

Nota: GruppoN e NomeN/ValoreN sono alternativi, non si possono usare entrambi con lo stesso valore di N.

Nota: per i campi numerati non è necessario utilizzare tutti i numeri consecutivi, funziona senza problemi anche se si lasciano dei "buchi" nella sequenza. Anzi, è preferibile lasciare dei buchi, così in caso di futura aggiunta di campi intermedi non si è costretti a rinumerare l'intero template.

{{Infobox
|TitoloInt       = 
|StileTitoloInt  = background-color:
|Immagine        = 
|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:
}}

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}}
|LinkWikidata    =
|Summary         = Tabella sinottica che riassume i dati principali del soggetto
|StileTabella    = 
|TitoloEst       = 
|StileTitoloEst  = 
|TitoloInt       = 
|StileTitoloInt  =
|SottoTitolo     = 
|Immagine        = 
|StileImmagine   = 
|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 =
}}

Se l'infobox pesca dati da Wikidata, è opportuno compilare i seguenti due parametri al fine di facilitare la modifica dei valori estratti.

NomeTemplate

Il nome senza prefisso del template verso cui deve puntare il link del manuale. Si può utilizzare {{subst:PAGENAME}}. Se questo parametro è omesso, nemmeno il link all'elemento Wikidata sarà mostrato.

LinkWikidata

Se impostato a qualunque valore, esempio "LinkWikidata = sì", ed è compilato NomeTemplate, genera il link all'elemento Wikidata collegato alla pagina in cui il template è usato.

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.

SottoTitolo

Viene inserito in formato più piccolo subito sotto al titolo. Da compilare con iniziale minuscola se non in caso di nomi propri.

Summary

descrizione generale della tabella, è invisibile e usata soprattutto dai browser per non vedenti. Default: "Tabella sinottica che riassume i dati principali del soggetto".

Immagine

un'immagine che viene posta dopo il titolo. Utilizzare il template {{Immagine sinottico}}. L'immagine è centrata per default. Notare che le immagini possono essere inserite in qualunque punto, allo stesso modo, usando un qualunque campo ValoreN. Si consiglia di usare una sintassi simile alla seguente:

|Immagine={{Immagine sinottico|{{{immagine}}}|{{{didascalia}}}}}

dove immagine è il nome del parametro che l'utente userà per passare il nome dell'immagine da visualizzare, didascalia il nome del parametro che conterrà il testo della didascalia dell'immagine. Per altri parametri che è possibile passare vedi il manuale di {{Immagine sinottico}}.

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. Accetta il valore speciale $fine per impedire che righe successive attivino il GruppoOpzionale che lo precede. Questo può essere utile per esempio se si vuole che l'ultima riga di un infobox dedicata a note generiche attivi l'etichetta di un GruppoOpzionale che non ha contenuti di per sè.

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.

NodoN

una o più righe create da zero ad esempio con un sottotemplate e/o con la funzione arraytostring del modulo:String. È un'alternativa ai parametri precedenti che permette di generare righe simili tra di loro in maniera dinamica e modulare. Le righe devono essere create con i tag HTML come <tr><td></td></tr>, mentre il markup wiki delle tabelle non è valido. Il sottotemplate che restituisce i tag può anche essere un altro template:Infobox annidato col parametro CreaTable=no.

Ultima

il contenuto dell'ultima riga con carattere piccolo (piede). Di solito viene utilizzata per note, riferimenti o altre informazioni dello stesso tipo.

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.

StileGruppo

Stile per tutte le celle contenenti i titoli dei sottogruppi (parametro GruppoN o "GruppoOpzionaleN". Spesso si assegna un colore ("background-color" per lo sfondo, "color" per il primo piano).

StileNome

Influenza tutte le celle con le etichette.

StileValore

Influenza tutte le celle con i dati.

StileUltima

Influenza l'ultima riga. Spesso si assegna un colore ("background-color" per lo sfondo, "color" per il primo piano).

GruppoStileN

Stile specifico per la cella contenente il "GruppoN" o "GruppoOpzionaleN". Ha la precedenza su eventuale "StileGruppo".

NomeStileN

Stile specifico per la cella contenente il "NomeN". Ha la precedenza su eventuale "StileNome".

ValoreStileN

Stile specifico per la cella contenente il "ValoreN". Ha la precedenza su eventuale "StileValore".

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

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.

CreaTable

Se questo parametro è impostato a "no", l'infobox viene creato senza il tag table e può essere incorporato in un'altra tabella.

Posizione

Accetta i valori "testa", "corpo" e "coda" per permettere l'inserimento dell'infobox rispettivamente all'inizio, in mezzo, o alla fine di una sequenza di infobox uniti.

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.

Test infobox
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
Manuale

{{Infobox
|NomeTemplate    = Infobox/man
|StileTabella    = 
|TitoloInt       = Test ''infobox''
|StileTitoloInt  = background:#ccf;
|Immagine        = {{Immagine sinottico|example.png|Didascalia per example.png}}
|StileImmagine   = 
|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%;"

Progetto Template: collabora a Wikipedia sull'argomento template