Esta plantilla es una metaplantilla para la creación de plantillas de barras laterales, es decir, cuadros que son plantillas de navegación alineadas verticalmente . Las barras laterales, al igual que los cuadros de información , suelen ubicarse en el lado derecho de una página.
{{ Sidebar with collapsible lists }} es una versión de {{ Sidebar }} que agrega colapsabilidad a sus secciones, es decir, los medios para mostrar u ocultar secciones haciendo clic en enlaces al lado de sus encabezados.
Las plantillas que utilizan las clases class=navbox
( {{ navbox }} ) o class=nomobile
( {{ sidebar }} ) no se muestran en el sitio web para dispositivos móviles de Wikipedia en inglés. Las visitas a páginas desde dispositivos móviles representan aproximadamente el 68 % de todas las visitas a páginas (promedio de 90 días a septiembre de 2024 [actualizar]). En resumen, estas plantillas no se incluyen porque 1) no están bien diseñadas para dispositivos móviles y 2) aumentan significativamente el tamaño de las páginas (lo que es malo para las descargas desde dispositivos móviles) de una manera que no es útil para el caso de uso móvil. Puede revisar/ver phab:T124168 para obtener más información.
Tenga en cuenta que MOS:LEAD no recomienda la colocación de barras laterales en la sección principal de los artículos.
{{ Sidebar | name = {{ subst : PAGENAME }} | class = | wraplinks = <!-- "true" de lo contrario (predeterminado:) omitir --> | float = | templatestyles = | child templatestyles = | grandchild templatestyles = | títuloexternoclase = | títuloexterno = | topimageclass = | topimage = | topcaption = | clasepretitle = | pretítulo = | tituloclase = | titulo = | imageclass = | imagen = | título = | clase de encabezado = | clase de contenido = | clase anterior = | arriba = | encabezado1 = | clase de encabezado1 = | contenido1 = | clase de contenido1 = | encabezado2 = | encabezado2clase = | contenido2 = | contenido2clase = | encabezado3 = | encabezado3clase = | contenido3 = | contenido3clase = <!-- (omitiendo parámetros de encabezado/contenido infinitos) -->| debajo de clase = | abajo = | barra de navegación = }}
Tenga en cuenta que Wikipedia:Manual de estilo/Sección principal § Elementos desaconseja la colocación de barras laterales en la sección principal de los artículos, aunque se pueden incluir caso por caso.
No se requieren parámetros. Para que los enlaces de {{ navbar }} funcionen correctamente (a menos que se suprima su aparición; consulte el parámetro navbar a continuación), se debe establecer el nombre del parámetro (con el nombre de la página de la barra lateral). (Esto no se aplica si se utiliza directamente el módulo Lua que produce {{Sidebar}} , Module:Sidebar ).
Los parámetros TemplateStyles |templatestyles=
, |child templatestyles=
, y |grandchild templatestyles=
toman el nombre de página de una página TemplateStyles y lo convierten en una etiqueta TemplateStyles. La etiqueta TemplateStyles es una forma mucho más eficaz de agregar estilo a una barra lateral.
Algunas reglas de uso:
|class=
para que los estilos agregados a una barra lateral no se "filtren" a otra barra lateral. Por ejemplo, Template:DYK tools tiene |class=dyk-tools
y la página Template:DYK tools/styles.css.dyk-tools
tiene como objetivo todos los estilos agregados.table
ningún otro HTML de tabla en la página TemplateStyles). La estructura de tabla está en desuso y desaparecerá en algún momento en el futuro.Estas etiquetas se cargan en este orden: plantillas de estilos principales ( Módulo:Sidebar/styles.css ), plantillas de estilos, secundarias y luego secundarias, que se pueden usar para "conectar en cascada" los estilos.
|templatestyles=
|child templatestyles=
|templatestyles=
.|grandchild templatestyles=
|child templatestyles=
.La lista canónica de clases generadas con cada tipo de elemento de una barra lateral (es decir, generadas para todos los , o todos los casos de ) se puede encontrar en Módulo:Barra lateral/configuración en la tabla "clase". La siguiente es una lista no autorizada pero suficiente para la mayoría de los estilos genéricos:|contentn=
|above=
.sidebar
.sidebar-outer-title
|outertitle=
..sidebar-top-image
|topimage=
..sidebar-top-caption
|topcaption=
..sidebar-pretitle
.sidebar-pretitle-with-top-image
|pretitle=
. Solo se mostrará una de ellas por barra lateral, dependiendo de si |topimage=
está presente o no..sidebar-title
.sidebar-title-with-pretitle
|title=
. Solo se mostrará una de ellas por barra lateral, dependiendo de si |pretitle=
está presente o no..sidebar-image
|image=
..sidebar-caption
|caption=
..sidebar-above
|above=
..sidebar-heading
|headingn=
.sidebar-content
.sidebar-content-with-subgroup
|contentn=
.sidebar-below
|below=
..sidebar-navbar
|navbar=
.A continuación se muestra un ejemplo de una barra lateral que no necesita admitir plantillas secundarias propias (ya sea porque no tiene plantillas secundarias o porque no quiere plantillas secundarias):
{{ Barra lateral | título = Ejemplo secundario | clase = barra lateral-ejemplo | estilos_de_plantilla = Plantilla:Barra_lateral/ejemplo/estilos.css }}
Para ver un ejemplo de una barra lateral que tiene sus propios hijos y un ejemplo de uno de los hijos (las plantillas de nietos tienen un uso similar):
{{ Sidebar | title = {{{ title | Título Ejemplo secundario }}} | class = sidebar-example {{{ class |}}} | templatestyles = Template:Sidebar/example/styles.css | child templatestyles = {{{ child templatestyles |}}} } }
{{ Ejemplo de barra lateral/hijo | título = Ejemplo de título de nieto | clase = ejemplo-de-barra-lateral-hijo | plantilla-hijo-estilos = Plantilla:Ejemplo de barra lateral/hijo/estilos.css }}
{{ Normalwraplink }} se puede utilizar para manejar enlaces individuales que deben ajustarse dentro de la barra lateral o que, de otro modo, deben ajustarse para evitar que la barra lateral se vuelva demasiado ancha. Utilice , donde es el enlace largo sin sus corchetes.{{normalwraplink|longlinkname}}
|longlinkname
Utilice este |wraplinks=true
parámetro para habilitar el ajuste de enlaces (deshabilitando nowraplinks
la clase CSS) para toda la plantilla.
Se puede anidar (incrustar) una plantilla de barra lateral en otra mediante el uso del |child=
parámetro. Esta función se puede utilizar para crear una barra lateral modular o para crear secciones más definidas y lógicas.
{{ Sidebar | title = Título de nivel superior | content1 = {{ Sidebar | child = yes | title = Primera subsección | header1 = Encabezado 1.1 | content1 = Contenido 1.1 }} | content2 = {{ Sidebar | child = yes | title = Segunda subsección | header1 = Encabezado 2.1 | content1 = Contenido 2.1 }} | below = texto "debajo" }}
Tenga en cuenta que en los ejemplos anteriores la barra lateral secundaria se coloca en un content
campo, no en un heading
campo. Observe también que los subtítulos de sección no aparecen en negrita si no se especifica explícitamente. Para obtener encabezados de sección en negrita, mueva los títulos al heading
campo, utilizando
{{ Sidebar | title = Título de nivel superior | header1 = Primera subsección | content1 = {{ Sidebar | child = yes | header1 = Encabezado 1.1 | content1 = Contenido 1.1 }} | header2 = Segunda subsección | content2 = {{ Sidebar | child = yes | header1 = Encabezado 2.1 | content1 = Contenido 2.1 }} | below = texto "debajo" }}
Los siguientes parámetros están obsoletos en favor de TemplateStyles y las plantillas/módulos que los utilizan se clasifican en Category:Sidebars with styles needing conversion . La página de categorías tiene más información sobre conversión.
Un ejemplo de conversión real específico es Template:DYK tools , donde los estilos se trasladaron a Template:DYK tools/styles.css .