Modelo:Infobox/uso

Este modelo é un metamodelo: un modelo usado para construír outros modelos. Non está feito para usalo directamente nun artigo, pero pode usarse como base se é necesario. Mira Wikisource:Modelos para atopar unha introdución ás caixas de información e axuda sobre como diseñalas. Mira na Categoría:Caixas de información para atopar modelos específicos de caixas de información.

Uso

O seu uso é similar a {{navbox}}, pero con algunhas diferenzas. Cada fila na táboa pode ter unha cabeceira, un par etiqueta/dato ou só unha cela con datos. Estes son estados mutuamente exclusivos polo que ao definir unha fila como cabeceira e como par etiqueta/dato, ignórase o par etiqueta/dato.

Para engadir unha imaxe noutro sitio que non sexa na cabeceira da caixa de información, ou para inserir datos con forma libre, cómpre usar unha fila que teña só un campo de datos.

Rango de números

Os números das filas poden ir do 1 ó 99 (para situacións onde se precisen máis de 99 filas, mira a sección "Embedding" abaixo). Para permitir unha maior flexibilidade cando cambia o formato dunha caixa de información, pode ser útil utilizar números non consecutivos para a cabeceira e as filas de etiqueta/dato. Os parámetros para as novas filas pódense inserir no futuro sen ter que cambiar os números dos parámetros existentes. Por exemplo:

|header3  = Sección 1
|label5   = Etiqueta A
|data5    = Dato A
|label7   = Etiqueta C
|data7    = Dato C
|header10 = Sección 2
|label12  = Etiqueta D
|data12   = Dato D

Parámetros

Ligazóns ver/conversar/editar

name

Se este parámetro está presente, as ligazóns "ver/conversa/editar" engadiranse á parte inferior do infobox, apuntando ao modelo nomeado. Podes empregar {{subst:PAGENAME}}.

Este parámetro non adoita empregarse xa que pode levar aos usuarios a enganos cando queiran editar os datos do infobox.

Título

Sub-cabeceira do infobox

(o resto do infobox vai aquí)

Texto na cela superior do infobox

Sub-cabeceira do infobox

Segunda sub-cabeceira do infobox

(o resto do infobox vai aquí)

Hai dúas formas de poñe-lo título nun infobox. Unha amosa o título dentro dos bordos do infobox mentres que a outra fai que apareza por riba da caixa. Póden empregarse os dous xuntos, só un ou incluso ningún (isto último non é recomendado).

title

Texto a poñer para que apareza por riba da caixa.

above

Texto a poñer para que apareza na cela superior da caixa, dentro do bordo.

Contido opcional

subheader, subheader2

campos de título adicionais que se amosan baixo {{{title}}} e {{{above}}}.

image, image2

imaxes a amosar na parte superior do modelo. Use sintaxe completa, p.ex: [[Ficheiro:exemplo.png|200px|alt=Exemplo]]. A imaxe amósase centrada por defecto.

caption, caption2

Texto a amosar baixo as imaxes.

header(n)

Texto a usar coma cabezallo da fila n.

label(n)

Texto a usar coma etiqueta da fila n.

data(n)

Texto a amosar como datos na fila n.

below

Texto amosado na última cela inferior do modelo. Habitualmente reservado a campos de notas.

child

Vexa a sección Integración para máis detalles.

Nota: para calquera valor de (n) non se permiten tódalas combinacións de valores. A presenza de |header(n)= fará que os correspondentes parámetros |data(n)= |label(n)= (e |rowclass(n)=) sexan ignorados. A ausendia de |data(n)= fará que o correspondente |label(n)= se ignore. As combinacións válidas para cada liña son:

• |header(n)= |class(n)=
• |data(n)= |rowclass(n)= |class(n)=
• |label(n)= |data(n)= |rowclass(n)= |class(n)=

Estilo CSS opcional

bodystyle

Aplícase a todo o modelo

titlestyle

Aplícase só ao título. Non se aconsella engadir unha cor de fondo.

abovestyle

Aplícase só á cela "above". O estilo por defecto ten "font-size:large". Para texto de tamaño normal use "font-size:medium;".

imagestyle

Aplícase á cela da imaxe. Inclúe o texto do pé da imaxe, mais este debe definirse en captionstyle.

captionstyle

Aplícase ao pé da imaxe.

headerstyle

Aplícase a tódolos cabezallos de celas

labelstyle

Aplícase a tódolas etiquetas de celas

datastyle

Aplícase a tódolos datos das celas

belowstyle

Aplícase só a cela "below".

Clases HTML

bodyclass

Este parámetro insértase no atributo "clase" para todo o infobox.

titleclass

Este parámetro insértase no atributo "clase" para o título do infobox.

aboveclass

Este parámetro insértase no atributo "clase" para a cela "above".

aboverowclass

Este parámetro insértase no atributo "clase" para a fila enteira da cela "above".

subheaderclass

Este parámetro insértase no atributo "clase" para o subtítulo do modelo.

subheaderrowclass

Este parámetro insértase no atributo "clase" para a fila enteira do subtítulo.

imageclass

Este parámetro insértase no atributo "clase" para a imaxe.

imagerowclass1, imagerowclass2

Estes parámetros insértanse no atributo "clase" para as filas enteiras das imaxes.

rowclass(n)

Este parámetro insértase no atributo "clase" para a fila especificada, incluíndo a etiqueta e calquera outro texto nela.

class(n)

Este parámetro insértase no atributo "clase" para a cela da fila especificada. De non existir datos non ten efecto.

belowclass

Este parámetro insértase no atributo "clase" para a cela "below".

Microformatos

Este modelo soporta o engadido de información micro-formateada. Isto faise engadindo atributos de clase ás celas de datos, indicando o tipo de información contida. Exemplo:

|bodyclass = vcard

|class1 = fn
|class2 = org
|class3 = tel

Títulos en cursiva

Os títulos nas infobox pódense poñer en cursiva, introducindo o parámetro italic title.

• Activar a cursiva nos títulos indicando |italic title={{{italic title|}}} no infobox.
• Desactivar por defecto mais permitir algunhas instancias usando |italic title={{{italic title|no}}}
• Non amosar ningún título en cursiva, para o que hai que omitir este parámetro.

Facer que os campos sexan opcionais

Unha fila cunha etiqueta pero sen datos non se amosa. Isto permite a creación de filas de contido opcionais. Para facer que unha fila sexa opcional use un parámetro que por defecto teña unha cadea de caracteres baleira:

|label5 = Population
|data5  = {{{population|}}}

Desta forma se o artigo non define un valor para o parámetro na chamada ao infobox non se amosará a fila.

Pode incluír o parámetro enteiro nunha sentenza "#if" para que non se amose ningún texto a maiores se non se da un valor para o parámetro:

|label6 = Mass
|data6  = {{#if:{{{mass|}}}|{{{mass}}} kg}}

Para máis información sobre a sentenza #if, vexa meta:ParserFunctions##if:.

Pode facer que os cabezallos sexan opcionais da mesma forma:

{{Infobox
|name    = {{subst:PAGENAME}}
|title   = Exemplo de cabeceiras opcionais
|header1 = {{#if:{{{item_1|}}}{{{item_2|}}}{{{item_3|}}}|Cabeceira opcional}}
|label2  = ítem 1
|data2   = {{{item_1|}}}
|label3  = ítem 2
|data3   = {{{item_2|}}}
|label4  = ítem 3
|data4   = {{{item_3|}}}
}}

Exemplos

Proba de Infobox

Pé para imaxe
Cabeceira
Dato sen etiqueta
cabeceira, etiqueta e dato definidos
etiqueta e datos	etiqueta e datos
Texto final

{{Infobox
|name         = Infobox/doc
|bodystyle    = 
|title        = Proba de Infobox
|titlestyle   = 

|image        = [[Ficheiro:exemplo.png|200px|alt=Exemplo]]
|imagestyle   = 
|caption      = Pé para imaxe
|captionstyle = 
|headerstyle  = background:#ccf;
|labelstyle   = background:#ddf;
|datastyle    = 

|header1 = Cabeceira
|label1  = 
|data1   = 
|header2 = 
|label2  = Etiqueta que non se amosa
|data2   = 
|header3 =
|label3  = 
|data3   = Dato sen etiqueta
|header4 = cabeceira, etiqueta e dato definidos
|label4  = non se amosa
|data4   = non se amosa
|header5 =
|label5  = etiqueta e datos
|data5   = etiqueta e datos

|belowstyle = background:#ddf;
|below = Texto final
}}

Exemplo con bodystyle = width:20em; e labelstyle = width:33%;

Proba 2

Etiqueta 1	Datos 1
Etiqueta 2	Datos 2
Etiqueta 3	Datos 3
Cabeceira 4
Etiqueta 5	Datos 5: Lorem ipsum dolor sit amet.
Texto final

{{Infobox
|bodystyle   = width:20em;
|name        = Proba 2
|title       = Proba 2
|titlestyle  = 
|headerstyle = 
|labelstyle  = width:33%
|datastyle   = 

|header1 = 
|label1  = Etiqueta 1
|data1   = Datos 1
|header2 = 
|label2  = Etiqueta 2
|data2   = Datos 2
|header3 = 
|label3  = Etiqueta 3
|data3   = Datos 3
|header4 = Cabeceira 4
|label4  = 
|data4   = 
|header5 = 
|label5  = Etiqueta  5
|data5   = Datos 5: Lorem ipsum dolor sit amet.

|belowstyle = 
|below = Texto final
}}

Integración

Pódese integrar un infobox dentro de outro empregando o parámetro |child=. Isto permite crear un infobox modular ou seccións ben definidas.

Título superior

Sección 1
Etiqueta 1.1	Datos 1.1
Sección 2
Etiqueta 2.1	Datos 2.1
Texto final

{{Infobox
| title = Título superior
| data1 = {{Infobox
  | child = yes
  | title = Sección 1
  | label1= Etiqueta 1.1
  | data1 = Datos 1.1
}}
| data2 = {{Infobox
  | child = yes
  | title = Sección 2
  | label1= Etiqueta 2.1
  | data1 = Datos 2.1
}}
|belowstyle = 
|below = Texto final
}}

Título superior

Sección 1
Etiqueta 1.1	Datos 1.1
Sección 2
Etiqueta 2.1	Datos 2.1
Texto final

{{Infobox
| title = Título superior
| header1 = Sección 1
  {{Infobox
  | child = yes
  | label1= Etiqueta 1.1
  | data1 = Datos 1.1
}}
| header2 = Sección 2
  {{Infobox
  | child = yes
  | label1= Etiqueta  2.1
  | data1 = Datos 2.1
}}
|belowstyle = 
|below = Texto final
}}

Sintaxe completa en branco

O modelo pode manexar ata 99 filas. Neste exemplo só se inclúen 20 e non se inclúen os parámetros "class".

{{Infobox
|name         = {{subst:PAGENAME}}
|bodystyle    = 
|title        = 
|titlestyle   = 
|above        = 
|abovestyle   = 

|imagestyle   = 
|captionstyle = 

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

|headerstyle  = 
|labelstyle   = 
|datastyle    = 

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

|belowstyle =
|below = 
}}