Plantilla:CajaNav

[editar] [refrescar] Documentación de Plantilla

Esta plantilla proporciona una forma de hacer cajas de navegación, conteniendo una serie de listas de enlaces, de una forma relativamente rápida y sencilla. Tiene un estilo por defecto que se puede cambiar mediante parámetros.

Uso

Ejemplo: los parametros en blanco se deben quitar.

{{CajaNav
|bodyclass  = 
|name       = {{subst:PAGENAME}}
|title      = 
|titleclass = 
|image      = 
|above      = 

|group1     = 
|list1      = 

|group2     = 
|list2      = 
 ...
|group20    = 
|list20     = 

|below      = 
}}

Lista de parámetros

Los parámetros van en minúsculas. Son obligatorios name y title.

La lista de parámetros básicos es la siguiente:

bodyclass - aplica un atributo HTML class a la caja entera.

name - nombre de la plantilla

title - Texto en la barra de título

titleclass - aplica un atributo HTML class a la barra de título.

state - autocollapse, uncollapsed, collapsed: el estado de la caja, si está expandida o no, "autocollapse" contrae las navboxes que se encuentren apiladas automáticamente.

titlestyle - estilo CSS para la barra de título, por ejemplo: background:gray;

groupstyle - estilo CSS para los grupos de celdas, por ejemplo: background:#eee;

image - imagen opcional en el lado derecho, puramente decorativa, debe codificarse de esta forma [[Image:XX.jpg|90px|link=|alt=]].

imageleft - imagen opcional en el lado izquierdo.

above - texto que aparece sobre la sección de grupos/listas.

groupn - El texto a la izquierda antes de la lista-n, opcional.

listn - Los enlaces wiki de la lista, con frecuencia separados por puntos

below - texto opcional que aparece debajo de la sección grupos/listas.

Esta plantilla se ha realizado basándose en la más compleja y extensa de la Wikipedia, la descripción completa y extensa de todos los posibles parámetros y restricciones se puede consultar en wikipedia:en:Template:Navbox en inglés.

Ejemplos

Sin imagen

{{CajaNav
| name  = CajaNav/doc
| title = [[Plantilla:CajaNav|Ejemplo 1]]
| group1 = Razas
| list1  = ''Asura''{{puntito}} ''Charr''{{puntito}} ''Sylvari''

| group2 = Dragones
| list2  = ''Primordus''{{puntito}} ''Jormag''{{puntito}} ''Zhaitan''{{puntito}} ''Deep Sea dragon'' {{puntito}} ''Kralkatorrik''

| group3 = Profesiones
| list3  = ''Elementalista'' {{puntito}} ''Guerrero''
}}

Con imagen, sin grupos

{{CajaNav
| name  = CajaNav/doc
| title = [[Plantilla:CajaNav|Ejemplo 2]]
| image = [[Image:Icono-normas.png|80px|link=|alt=]]
| list1 = [[Firma tus comentarios]]{{puntito}}[[Consenso]]{{puntito}}[[Política de uso de imágenes]]
}}

Ejemplo 2 Firma tus comentarios · Consenso · Política de uso de imágenes

Con dos imágenes, sin grupos, listas múltiples

{{CajaNav
| name  = CajaNav/doc
| title = [[Plantilla:CajaNav|Ejemplo 3]]
| image = [[Imagen:Icono-normas.png|80px|link=|alt=]]
| imageleft = [[Imagen:Icono-Manual.png|80px|link=|alt=]]
| list1 = [[Firma tus comentarios]]{{puntito}}[[Consenso]]{{puntito}}[[Política de uso de imágenes]]
| list2 = [[Ayuda Manual:Cómo firmar|Cómo firmar]]{{puntito}}[[Ayuda:Manual:Guía para torpes|Tu primer artículo]]
| list3 = [[Ayuda:Redirección|Redirección]]{{puntito}}[[Ayuda:Manual:Plantilla|Plantilla]]
}}

Ejemplo 3 Firma tus comentarios · Consenso · Política de uso de imágenes Cómo firmar · Tu primer artículo Redirección · Plantilla

Con imagen, grupos, "above" y "below"

{{CajaNav
| name  = CajaNav/doc
| title = [[Plantilla:CajaNav|Ejemplo 4]]
| image = [[Image:Icono-normas.png|80px|link=|alt=]]

| above = El texto para "above" aparece aquí

| group1 = Primer grupo
| list1  = [[Ayuda:Redirección|Redirección]]
| group2 = Segundo grupo
| list2  = [[Ayuda:Manual:Plantilla|Plantilla]]

| group3 = Tercer grupo
| list3  = [[Firma tus comentarios]]{{puntito}}[[Consenso]]{{puntito}}[[Política de uso de imágenes]]

| group4 = Cuarto grupo
| list4  = [[Ayuda:Manual:Plantilla|Plantilla]]{{puntito}}[[Consenso]]

| group5 = Último grupo
| list5  = [[Ayuda:Redirección|Redirección]]{{puntito}}[[Ayuda:Manual:Plantilla|Plantilla]]

| below  = El texto de "below" aparecerá aquí. 
}}

Ejemplo 4 El texto para "above" aparece aquí Primer grupo Redirección Segundo grupo Plantilla Tercer grupo Firma tus comentarios · Consenso · Política de uso de imágenes Cuarto grupo Plantilla · Consenso Último grupo Redirección · Plantilla El texto de "below" aparecerá aquí.

Cajas de navegación hijas

Es posibles colocar varias cajas de navegación dentro de un único borde con el uso del parámetro border, o especificando el primer parámetro que será la "hija". La forma básica de hacer esto es como sigue (añade un subgrupo para el primer grupo/lista):

{{CajaNav
|name = {{subst:PAGENAME}}
|title = Titulo

|group1 = [opcional]
|list1 = {{CajaNav|child
   ...parámetros de la cajanav hija...
 }}

...
}}

Ejemplo de subgrupos

Página Principal: Plantilla:CajaNavSub

Este es un ejemplo de uso de subgrupos. Se recomienda que se use {{CajaNavSub}}, pero el mismo resultado se puede obtener usando el parámetro border = child o especificando el primer parámetro sin nombre como child.

Ejemplo 5: subgrupos múltiples Texto Above Grupo 1 Lista 1 Grupo 2 Grupo 2.1 Lista 1 Grupo 2.2 Lista 2 Grupo 2.3 Lista 3 Grupo 3 Lista 3 Grupo 4 Grupo 4.1 Lista 1 Grupo 4.2 Lista 2 Grupo 4.3 Lista 3 Texto Below

Varios esconder/mostrar en un único contenedor

Página Principal: Plantilla:CajaNavColap

El ejemplo siguiente está generado usando una CajaNav normal para el contenedor principal, y después otras CajaNav para las listas 1, 2 y 3, usando border = child. Nótese que las cajas hijas no necesitan valor para el parámetro name.

Ejemplo 4 Ejemplo 4: Caja hija 1 Grupo 1 Lista 1 Grupo 2 Lista 2   Lista 3 Grupo4 Lista 4 Ejemplo 4: Caja hija 2 lista 1 lista 2 Texto below Ejemplo 4: Caja hija 3 Grupo 1 Lista 1 Grupo 1 Lista 1

Relación con otras plantillas de cajas de navegación

Esta caja está especialmente diseñada para trabajar en conjunción con otras dos plantillas "hermanas": {{CajaNavCols}} y {{CajaNavColap}}. Las tres plantillas comparten parámetros comunes por consistencia y facilidad de uso, por eso se han dejado en inglés. Además, las tres plantillas pueden usarse como hijas unas de otras (usando el parámetro border = child) o especificando el primer parámetro sin nombre como child (por ejemplo: {{CajaNav|child, {{CajaNavCols|child, o {{CajaNavColap|child).

Detalles técnicos

• Esta plantilla usa clases CSS para la mayor parte de su aspecto, pero es completamente personalizable. Lo que proporcionan las clases CSS que usa es una apariencia por defecto. Las clases se encuentran definidas en MediaWiki:common.css
• Internamente la metaplantilla usa el lenguaje de marcas HTML en lugar del propio de wiki para codificar las tablas.
• Las clases que usa se encuentran definidas en MediaWiki:common.css y las tablas colapsables están definidas en MediaWiki:common.js.

Diseño

• El borde de 2px entre grupos y listas está hecho usando la propiedad border-left de las listas. Por tanto, si se desea cambiar el color background de la plantilla (por ejemplo con bodystyle = background:purple;), es necesario hacer coincidir el color de border-left con el color al que queremos cambiar: liststyle = border-left-color:purple;. Si se desea un borde alrededor de cada lista, entonces el borde de 2px desaparecerá.
• La propiedad width de las listas es inicialmente 100%. Por tanto, si se desea cambiar manualmente el ancho de las celdas de grupo, también se necesitará especificar el liststyle para tener width:auto. Si quieres ajustar el ancho del grupo y usar imágenes, depende de ti el especificar el CSS en los parámetros groupstyle, liststyle, imagestyle, y imageleftstyle para que todo funcione correctamente.

Ejemplo para ajustar el ancho de grupo:

groupstyle = width:10em;

liststyle = width:auto;

• Los valores por defecto de margin-left y margin-right de la CajaNav exterior están especificados como "auto;". si se quiere usar una CajNav como float, se deben especificar manualmente estos parámetros margin-left y margin-right values, porque los márgenes automáticos interfieren con la opción float. Por ejemplo se puede añadir el siguiente código para conseguirlo:

style = width:22em;float:right;margin-left:1em;margin-right:0em;