<slot>...</slot>

HTML4 HTML5

La etiqueta <slot> es un elemento especial en la tecnología Web Components (Shadow DOM). Sirve como un marcador de posición (un placeholder) dentro de la plantilla de un componente, en el cual el desarrollador de la página puede inyectar su propio contenido HTML externo.

Gracias a él, es posible crear componentes flexibles y reutilizables cuya estructura interna se define una sola vez, pero el contenido de secciones individuales (como el encabezado o el pie de página) se puede modificar desde el exterior.

Ambas etiquetas, de apertura y de cierre, son obligatorias.

Atributos:

Ejemplo 1

En el siguiente ejemplo, se define una plantilla de tarjeta de componente en la que la etiqueta <slot> con el atributo name="card-text" establece un lugar para texto personalizado. Si el usuario del componente no pasa su propio contenido, se mostrará el texto por defecto ubicado dentro del slot:

Código:

<template id="custom-card-template"> <div style="border: 1px solid #999; padding: 10px; border-radius: 4px;"> <h3 style="margin-top: 0;">Tarjeta de componente</h3> <p> <slot name="card-text">Este es el texto por defecto de la tarjeta (se muestra cuando falta contenido personalizado).</slot> </p> </div> </template>

El navegador interpretará esta plantilla y sus slots (después de renderizarse en el componente) de la siguiente manera:

Tarjeta de componente

Este es el texto por defecto de la tarjeta (se muestra cuando falta contenido personalizado).

Ejemplo 2: Dos slots (uno con contenido predeterminado y otro con contenido inyectado)

En este ejemplo, el componente tiene dos slots: title y footer. En el primer slot inyectamos nuestro propio encabezado desde fuera, mientras que el segundo slot permanece vacío en la llamada, por lo que el navegador muestra el contenido por defecto integrado en su lugar:

Código:

<!-- Plantilla de componente con dos slots --> <template id="user-card-template"> <div style="border: 1px solid #666; padding: 12px;"> <header> <slot name="title">Título predeterminado del encabezado</slot> </header> <footer style="margin-top: 10px; font-size: 0.9em; color: #555;"> <slot name="footer">Contenido predeterminado del pie de página del componente</slot> </footer> </div> </template> <!-- Uso del componente: inyectamos un título personalizado y dejamos el pie de página por defecto --> <user-card> <h4 slot="title" style="margin: 0;">Título inyectado: Perfil de usuario</h4> </user-card>

El navegador interpretará este diseño de la siguiente manera (el encabezado ha sido reemplazado por contenido propio, mientras que en el pie de página se conserva el texto por defecto):

Título inyectado: Perfil de usuario