Plantilla:Infobox

Prova Infotaula
Etiqueta 1	Dada 1
Etiqueta 2	Dada 2
Etiqueta 3	Dada 3
Encapçalament 4
Etiqueta 5	Dada 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
	Text de baix de tot

Prova Infotaula
Text de dalt de tot
	Subencapçalament sota "above"
	Segon subencapçalament
	Text de peu d'imatge example.png
Encapçalament definit sol
	Dada definida sola
Els tres definits (capçalera, etiqueta, dada, totes amb mateix número)
Etiqueta i dada definides (label)	Etiqueta i dada definides (data)
	Text de baix de tot

Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

Aquesta plantilla utilitza una crida a un mòdul de tipus Lua, nom que li ve del llenguatge Lua que utilitza. Per tant, si volguéssiu modificar-la, abans hauríeu d'estar familiaritzats amb aquest llenguatge i les funcions de l'extensió Scribunto. Vegeu com fer proves de plantilles.

Aquesta plantilla utilitza el següent mòdul:

Mòdul:Infobox

Ús

{{Infotaula}} (o {{Infobox}}, per la denominació anglesa), serveix per a fer taules ben estructurades de forma senzilla.

Vegeu també altres infotaules més específiques.

Si voleu que algun dels paràmetres no es mostri quan no s'empleni afegiu | en la casella del nom del paràmetre tal i com es mostra en un exemple a continuació:

| label1 = Població
| data1  = {{{població|}}}

Per a paràmetres que hagin de contenir més informació a banda del propi inclòs en el paràmetre podeu fer servir la següent sintaxi:

| label1 = Població
| data1  = {{#if:{{{població|}}}|{{{població}}} hab.}}

Eviteu fer servir sintaxis que continguin la fórmula "hiddenStructure", ja que no funciona.

Sintaxi

(Nota: la plantilla suporta les línies que facin falta i que aquí només se n'inclouen 20, ja que les infotaules més llargues són poc utilitzades. Només hem de posar les que necessitem. El paràmetres microformat "class" s'han omès a la mostra ja que normalment no es fan servir.) (Nota 2: Si una secció header té un número, els paràmetres label i data n'hauran de tenir el següent, mai el mateix (si no no apareixeran)).

Hi ha dos tipus de paràmetres:

Paràmetres de control

Serveixen per configurar el format de la infotaula: colors, amplada, lletra, etc. de les diferents parts de la infotaula.

bodystyle = defineix el format global de la taula: amplada, color de fons, etc. i valors per defecte per als continguts: format text,..
titlestyle = defineix les característiques de la línia "title"
abovestyle = defineix les característiques de la línia "above"
subheaderstyle = defineix les característiques de les línies "subheader"
imagestyle = defineix les característiques de la imatge. En general, no es fa servir, ja que el format de les imatges s'acostuma a posar dins el codi de la infotaula.
captionstyle = defineix les característiques de la línia "caption", el peu de foto.
headerstyle = defineix les característiques de les header(s)
headerstylen = defineix les característiques específiques per la línia de capçalera "n"
belowstyle = defineix les característiques de la línia "below"
labelstyle = defineix les característiques de la part "label" de les línies de contingut.
datastyle = defineix les característiques de la part "data" de les línies de contingut.
rowstylen = defineix les característiques específiques per la línia de contingut "n"
belowstyle = defineix les característiques de la línia "below"

Paràmetres de contingut

s'emplenen amb el contingut que es mostrarà a la infotaula.

title = línia a sobre de la caixa de la infotaula
above = línia superior dins de la infotaula
subheadern = línia immediatament inferior a la "above"; pot haver "n"
imagen = imatge; pot haver "n"
captionn = peu d'imatge; pot haver "n".
below = línia al peu de la infotaula

headern = capçaleres intermedies; pot haver "n" amb una numeració correlativa comuna amb label i data
labeln i datan = juntes formen una línia de contingut; labeln és l'etiqueta que descriu el valor mostrat a datan. El labeln només es mostra si el corresponent datan té contingut

{{Infotaula
| name         = {{subst:PAGENAME}}
| bodystyle    = 
| titlestyle   = 
| abovestyle   = 
| imagestyle   = 
| captionstyle = 
| headerstyle  = 
| belowstyle   = 
| labelstyle   = 
| datastyle    = 

| title        = 
| above        = 

| image        = 
| caption      = 
| image2       =
| caption2     = 

| header1  = 
| label1   = 
| data1    = 
| header2  = 
| label2   = 
| data2    = 
| header3  = 
| label3   = 
| data3    = 
| header4  = 
| label4   = 
| data4    = 
| header5  = 
| label5   = 
| data5    = 
| header6  = 
| label6   = 
| data6    = 
| header7  = 
| label7   = 
| data7    = 
| header8  = 
| label8   = 
| data8    = 
| header9  = 
| label9   = 
| data9    = 
| header10 = 
| label10  = 
| data10   = 
| header11 = 
| label11  = 
| data11   = 
| header12 = 
| label12  = 
| data12   = 
| header13 = 
| label13  = 
| data13   = 
| header14 = 
| label14  = 
| data14   = 
| header15 = 
| label15  = 
| data15   = 
| header16 = 
| label16  = 
| data16   = 
| header17 = 
| label17  = 
| data17   = 
| header18 = 
| label18  = 
| data18   = 
| header19 = 
| label19  = 
| data19   = 
| header20 = 
| label20  = 
| data20   = 

|below      = 
}}

Exemples

Observeu com la fila no apareix en la infotaula (que es mostra a continuació) quan una label es defineix sense un cel·la data que l'acompanyi, i com totes es mostren quan un header es definit en la mateixa fila que una cel·la data. Observeu també que els subheaders no estan en negreta per defecte, com els headers utilitzats per dividir la secció de dades principal, ja que aquest paper està destinat a ser per a la cel·la above:

{{Infotaula
 |name         = {{subst:PAGENAME}}
 |bodystyle    = 

 |titlestyle   = 
 |abovestyle = background:#cfc;
 |subheaderstyle =
 |title        = Prova Infotaula
 |above        = Text de dalt de tot
 |subheader    = Subencapçalament sota "above"
 |subheader2   = Segon subencapçalament

 |imagestyle   = 
 |captionstyle = 
 |  image      = [[Fitxer:example.png|200px|alt=Exemple de text alternatiu]]
 |caption      = Text de peu d'imatge example.png

 |headerstyle  = background:#ccf;
 |labelstyle   = background:#ddf;
 |datastyle    = 

 |header1 = Encapçalament definit sol
 | label1 = 
 |  data1 = 
 |header2 = 
 | label2 = Etiqueta definida sola que no es mostra (necessita data, o és suprimida)
 |  data2 = 
 |header3 =
 | label3 = 
 |  data3 = Dada definida sola
 |header4 = Els tres definits (capçalera, etiqueta, dada, totes amb mateix número)
 | label4 = no es mostra (mateix nombre que una capçalera)
 |  data4 = no es mostra (mateix nombre que una capçalera)
 |header5 =
 | label5 = Etiqueta i dada definides (label)
 |  data5 = Etiqueta i dada definides (data)

 |belowstyle = background:#ddf;
 |below      = Text de baix de tot
}}

Per a aquest exemple, els paràmetres bodystyle i labelstyle s'utilitzen per ajustar l'ample de la infotaula i definir un ample predeterminat de la columna de les etiquetes:

{{Infotaula
 |name        = {{subst:PAGENAME}}
 |bodystyle   = width:20em

 |titlestyle  = 
 |title       = Prova Infotaula

 |headerstyle = 
 |labelstyle  = width:33%
 |datastyle   =

 |header1 = 
 | label1 = Etiqueta 1
 |  data1 = Dada 1
 |header2 = 
 | label2 = Etiqueta 2
 |  data2 = Dada 2
 |header3 = 
 | label3 = Etiqueta 3
 |  data3 = Dada 3
 |header4 = Encapçalament 4
 | label4 = 
 |  data4 = 
 |header5 = 
 | label5 = Etiqueta 5
 |  data5 = Dada 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

 |belowstyle = 
 |below = Text de baix de tot
}}

Amb infotaules incrustades

Una plantilla d'infotaula pot ser incrustada en una altra mitjançant el paràmetre |child=. Aquesta característica es pot utilitzar per crear una infotaula modular, o per crear seccions lògiques més ben definides. Anteriorment, era necessari utilitzar la incrustació amb la finalitat de crear infotaules amb més de 99 files, però ara no hi ha límit per al nombre de files que es pot definir en una sola instància de {{Infotaula}}

Títol de dalt de tot
Primera subsecció
Etiqueta 1.1	Dada 1.1

Segona subsecció
Etiqueta 2.1	Dada 2.1

Text de baix de tot

{{Infotaula
 | title = Títol de dalt de tot
 | data1 = {{Infotaula | decat = yes | child = yes
    | title = Primera subsecció
    | label1= Etiqueta 1.1
    | data1 = Dada 1.1
   }}
 | data2 = {{Infotaula | decat = yes | child = yes
  |title = Segona subsecció
  | label1= Etiqueta 2.1
  | data1 = Dada 2.1
  }}
 | belowstyle = 
 | below = Text de baix de tot
}}

Observeu que, en els exemples anteriors, la infotaula continguda és col·locada en un camp data, no en un camp header. Observe que els encapçalaments de les seccions ja no estan en negreta si no s'especifica explícitament que ho estiguin. Per obtenir encapçalaments de les seccions en negreta poseu la infotaula continguda en un camp header (però no en un camp label, ja que no es mostraria!), o utilitzeu:

Títol de dalt de tot
Primera subsecció
Etiqueta 1.1	Dada 1.1

Segona subsecció
Etiqueta 2.1	Dada 2.1

Text de baix de tot

{{Infotaula
 | title = Títol de dalt de tot
 | header1 = {{Infotaula | decat = yes | child = yes
    | title = Primera subsecció
    | label1= Etiqueta 1.1
    | data1 = Dada 1.1
   }}
 | header2 = {{Infotaula | decat = yes | child = yes
    | title = Segona subsecció
    | label1= Etiqueta 2.1
    | data1 = Dada 2.1
   }}
 | belowstyle = 
 | below = Text de baix de tot
}}

o,

Títol de dalt de tot
Primera subsecció
Etiqueta 1.1	Dada 1.1

Segona subsecció
Etiqueta 2.1	Dada 2.1

Text de baix de tot

{{Infotaula
 | title = Títol de dalt de tot
 | header1 = Primera subsecció
   {{Infotaula | decat = yes | child = yes
    | label1 = Etiqueta 1.1
    |   data1 = Dada 1.1
   }}
 | header2 = Segona subsecció
   {{Infotaula | decat = yes | child = yes
    | label1 = Etiqueta 2.1
    |  data1 = Dada 2.1
   }}
 | belowstyle = 
 | below = Text de baix de tot
}}

Observeu que ometent el paràmetre |title=, i sense incloure cap text que precedeixi a la infotaula incrustada, poden quedar files de la taula en blanc, creant llacunes en la presentació visual.

Amb sub-infotaules

Un mètode alternatiu per a la incrustació és utilitzar |subbox=yes, que elimina la vora exterior de la infotaula, però conserva l'estructura interior. Una característica d'aquest enfocament és que les infotaules contenidores i contingudes no necessiten tenir la mateixa estructura, i els camps d'etiqueta i dades no estan alineats entre les infotaules contenidores i contingudes, ja que no estan en la mateixa taula contenidora.

Encapçalament 1

Encapçalament 2

Subencapçalament 3-1
Subencapçalament 3-2
Etiqueta 3-3	Dada 3-3

Etiqueta 4-1	Dada 4-1

Etiqueta 5

Dada 5

Principal 6

{{Infotaula
 | headerstyle = background-color:#eee;
 | labelstyle  = background-color:#eee;
 | header1 = Encapçalament 1
 | header2 = Encapçalament 2
 |   data3 = {{Infotaula | subbox = yes
    | headerstyle = background-color:#ccc;
    | labelstyle  = background-color:#ddd;
    | header1 = Subencapçalament 3-1
    | header2 = Subencapçalament 3-2
    |  label3 = Etiqueta 3-3    |   data3 = Dada 3-3
   }}
 |   data4 = {{Infotaula | subbox = yes
    | labelstyle  = background-color:#ccc;
    |  label1 = Etiqueta 4-1    |   data1 = Dada 4-1
   }}
 |  label5 = Etiqueta 5 |   data5 = Dada 5
 | header6 = Principal 6
}}

Tècniques d'incrustació similars poden ser utilitzades dins dels paràmetres de contingut d'algunes "infotaules" d'altres plantilles (per exemple, en la {{Barra lateral}}) :

{{Barra lateral
 | navbar = off
 | headingstyle = background-color:#eee;
 | heading1 = Encapçalament 1
 | heading2 = Encapçalament 2
 | content3 = {{Infotaula | subbox = yes
    | headerstyle = background-color:#ccc;
    | labelstyle = background-color:#ddd;
    | header1 = Subencapçalament 3-1
    | header2 = Subencapçalament 3-2
    |  label3 = Etiqueta 3-3 |   data3 = Dada 3-3
   }}
 | content4 = {{Infotaula | subbox = yes
    | labelstyle = background-color:#ccc;
    |  label1 = Etiqueta 4-1 |   data1 = Dada 4-1
   }}
 | heading5 = Encapçalament 5
}}

Tingueu en compte que l'ompliment predeterminat de la cel·la de dades que conté cada una de les sub-infotaules contenidores és encara visible, de manera que les sub-infotaules són lleugerament més estretes que la infotaula contenidora i hi ha un espai vertical més alt entre les cel·les normals de la infotaula contenidora que en les cel·les de les diferents sub-infotaules.

Ús de TemplateStyles

Els paràmetres de configuració de la infotaula es poden informar directament amb comandaments CSS style, tal com es descriu a la taula resum al final d'aquesta documentació.

Una altra forma de definir la configuració és mitjançant una TemplateStyles, és a dir, la creació d'un conjunt de classes personalitzades per una determinada infotaula en lloc de tenir-les al catàleg comú de mediawiki:Common.css. Per aconseguir que la infobox recuperi aquests valor, cal definir unes classes alternatives als styles.

bodyclass = infobox_bodystyle
titleclass = infobox_titlestyle
aboveclass = infobox_abovestyle
headerclass = infobox_headerstyle
classnn = rownn

Exemple d'utilització de classes

Exemple amb la seva TemplateStyles particular.

Aquest plantilla utilitza TemplateStyles:

template:Infobox/testclasses/styles.css

Títol supra infobox
Títol interior molt, però que molt, molt llarg
label5	data5
header nou
label11	data11
text amb class txtquestion
header 14
label15	data15

{{infobox 
|bodyclass    = infobox_bodystyle
|titlestyle   = background:#AFEEEE;        <!-- definit via titlestyle, no per class -->
|aboveclass   = infobox_abovestyle aboveicon
|headerclass  = infobox_headerstyle 
|datastyle    = text-align:start
|captionstyle = font-size:90%;
| title    = Títol supra infobox
| above    = <span style="float:left; margin-left: 3px;">[[Fitxer:null.png|35px|Infotaula eleccions|link=]]</span>Títol interior molt, però que molt, molt llarg
| label5   = label5 
|  data5   = data5
| class9   = row9      <!-- color particular per la línia 9 (header) -->
| header9  = header nou
| label11  = label11
|  data11  = data11
| class12  = txtquestion  <!-- color i estil particular per la línia 12 (data) -->
|  data12  = text amb class txtquestion
| header14 = header 14
| class15  = row15     <!-- color particular per la línia 15 (data) --> 
| label15  = label15
|  data15  = data15
}}

Vegeu també

Estil recomanat per imatge + caption per minimitzar la separació:

 imagestyle   = padding-bottom:0.1em;line-height:1.35;font-size:98%;
 captionstyle = padding-top:0.3em;padding-bottom:0.1em;line-height:1.35;font-size:98%;

La documentació de més amunt està transclosa de Plantilla:Infobox/ús. (modifica | historial)
Els editors poden fer proves amb aquesta plantilla al seu espai de proves (crea | modifica)
Afegiu categories en la subpàgina /ús. Vegeu les subpàgines d'aquesta plantilla, utilització de paràmetres.