Plantilla:CajaInfo/doc

Esta es una subpágina de documentación para Plantilla:CajaInfo. Contiene información de uso, categorías y/o enlaces interwikis.

Esta plantilla está diseñada para ser usada como metaplantilla: sirve para construir otras plantillas. No se debe usar directamente en un artículo.

Uso

La forma de usarla es similar a {{CajaNav}}, pero con una diferencia importante. Cada fila de la tabla puede contener:

• Una cabecera header
• Una pareja etiqueta/valor label/data
• Simplemente un valor, datos libres.

Son mutuamente exclusivos, si se define una fila tanto con cabecera como con una pareja etiqueta/valor, la pareja se ignora.

Para insertar imágenes en otro lugar que no sea la parte superior de la caja, o insertar datos libres, se debe usar una fila sólo con datos.

Rangos numéricos

Para permitir más flexibilidad a la hora de cambiar una cajainfo, puede ser útil usar números no contiguos para las filas cuando se está diseñando la caja. De esta forma se podrán insertar nuevos parámetros en el futuro sin necesidad de renumerar los existentes. Por ejemplo:

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

Parámetros

Título

Hay dos formas diferentes de ponerle un título a una cajaInfo. Una es para el título que va dentro del borde de la caja, y la otra lo coloca sobre la caja como una leyenda. Se pueden usar los dos a la vez, o sólo uno de ellos, o incluso ninguno, pero esto último no se recomienda.

title 

Texto para la leyenda sobre la caja

above 

Texto para la celda superior de la caja

Contenido opcional

subheader, subheader2 

campos de títulos adicionales que encajan dentro de {{{title}}} y {{{above}}}

image, image2 

imágenes a mostrar en parte superior de la plantilla. Hay que usar la sintaxis completa para imágenes, por ejemplo [[Archivo:ejemplo.png|200px|alt=texto ejemplo]]. La imagen por defecto va centrada

caption, caption2 

Texto a colocar bajo las imágenes

header(n) 

Texto para usar como cabecera en la fila n

label(n)

Texto para usar como etiqueta en la fila n

data(n)

Texto para usar como datos en la fila n

below

Texto para la celda de más abajo. La intención de uso de esta celda es para notas de pie de página y otra información adicional

child

Se usa para poder incrustar unas cajas dentro de otras. Detalles en la sección cajas hijas

Estilos CSS opcionales

bodystyle 

Se aplica a la tabla de la cajaInfo por completo

titlestyle 

Se aplica sólo al título de tipo leyenda. Se desaconseja añadir un color de fondo (background) porque aparece fuera de la caja

abovestyle 

Se aplica a la celda above

imagestyle 

Se aplica a la celda que contiene la imagen

captionstyle 

Se aplica al texto de leyenda de la imagen

headerstyle 

Se aplica a todas las celdas cabecera

labelstyle 

Se aplica a todas las celdas etiqueta

datastyle 

Se aplica a todas las celdas de datos

belowstyle 

Se aplica sólo a la celda below

Clases HTML

bodyclass 

Este parámetro se inserta en el atributo "class" de la cajaInfo completa.

titleclass 

Este parámetro se inserta en el atributo "class" del title

aboveclass 

Este parámetro se inserta en el atributo "class" de la celda above

aboverowclass 

Este parámetro se inserta en el atributo "class" de la fila de la tabla donde se encuentra above

subheaderclass 

Este parámetro se inserta en el atributo "class" de subheader.

subheaderrowclass 

Este parámetro se inserta en el atributo "class" de la fila de la tabla donde se encuentra subheader

imageclass 

Este parámetro se inserta en el atributo "class" de la imagen.

imagerowclass1, imagerowclass2 

Estos parámetros se insertan en el atributo "class" las filas de las imágenes

rowclass(n) 

Este parámetro se inserta en el atributo "class" de la fila especificada, incluyendo la etiqueta.

class(n) 

Este parámetro se inserta en el atributo "class" de la celda de datos de la fila especificada

belowclass 

Este parámetro se inserta en el atributo "class" de la celda below

Haciendo campos opcionales

Una fila con etiqueta pero sin datos no se muestra. Esto permite la creación de filas de contenido opcional en la cajaInfo fácilmente. Para hacer una fila opcional debe usarse un parámetro que tome como valor por defecto la cadena vacía, por ejemplo:

|label5 = Especie
|data5  = {{{especie|}}}

De esta manera, si un artículo no define el parámetro especie en su caja, la fila no se mostrará.

Para campos más complejos, con contenido pre-formateado que está presente incluso cuando el parámetro no tiene valor, se puede englobar todo en una sentencia #if, de modo que toda la fila desaparezca cuando no se usa el parámetro. Por ejemplo, en el siguiente código se especifica que "#if parámetro precio se proporciona | entonces muéstralo, seguido por 'monedas'":

|label6 = Precio
|data6  = {{#if:{{{precio|}}}|{{{precio}}} monedas}}

Para más información sobre #if ver ParserFunctions

También se puede hacer cabeceras opcionales de un modo similar. Si quieres que una cabecera sólo aparezca si uno o más de los campos de datos bajo ella se proporcionan, se puede usar el patrón siguiente como modelo de cómo hacerlo.

{{Infobox
|title   = Ejemplo de una cabecera opcional
|header1 = {{#if:{{{item_uno|}}}{{{item_dos|}}}{{{item_tres|}}}|Cabecera opcional}}
|label2  = Item uno
|data2   = {{{item_uno|}}}
|label3  = Item dos
|data3   = {{{item_dos|}}}
|label4  = Item tres
|data4   = {{{item_tres|}}}
}}

Cajas hijas

Una plantilla cajaInfo puede inscrustarse dentro de otra usando el parámetro child. Esta característica puede usarse para crear una cajaInfo modular, o para crear secciones lógicas mejor definidas.

{{CajaInfo
| title = Título nivel superior
| data1 = {{CajaInfo
  | child = si
  | title = Primera subsección
  | label1= Etiqueta 1.1
  | data1 = Datos 1.1
}}
| data2 = {{CajaInfo
  | child = si
  | title = Segunda subsección
  | label1= Etiqueta 2.1
  | data1 = Datos 2.1
}}
|belowstyle = 
|below = Texto Below
}}

Ejemplos

CajaInfo Test

Título de la imagen
Cabecera principal
Datos definidos sin etiqueta
Todo definido (header, label, data, con el mismo índice)
Etiqueta y datos definidos (label)	Etiqueta y datos definidos (data)
Texto final

{{CajaInfo
|name         = CajaInfo/doc
|bodystyle    = 
|title        = CajaInfo Test 
|titlestyle   = 

|image        = [[Archivo:Ed política.png|200px|alt=Edificio]]
|imagestyle   = 
|caption      = Título de la imagen
|captionstyle = 
|headerstyle  = background:#C1C4BA;
|labelstyle   = background:#DADCD6; 
|datastyle    = 

|header1 = Cabecera principal
|label1  = 
|data1   = 
|header2 = 
|label2  = Sólo etiqueta, sin valor, como no tiene valor no aparece
|data2   = 
|header3 =
|label3  = 
|data3   = Datos definidos sin etiqueta
|header4 = Todo definido (header, label, data, con el mismo índice)
|label4  = no se muestra (mismo índice que header)
|data4   = no se muestra (mismo índice que header)
|header5 =
|label5  = Etiqueta y datos definidos (label)
|data5   = Etiqueta y datos definidos (data)

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

Sintaxis completa

(Nota: La plantilla soporta actualmente hasta 80 filas, sólo se incluyen 20 aquí a modo de ejemplo)

{{CajaInfo
|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 = 
}}

Información adicional

Esta plantilla está adaptada de la más compleja de Wikipedia: Template:Infobox.En wikipedia podemos encontrar diversos artículos que sirven de guía y ayuda para diseñar buenas cajas de información, en inglés:

• Diseñando Infoboxes
• Wikipedia:Manual of Style (infoboxes)
• Wikipedia:Thinking outside the infobox
• Wikipedia:Disinfoboxes
• Help:Infobox