Un elemento propio
class SaludoUsuario extends HTMLElement {
connectedCallback() {
const nombre = this.getAttribute("nombre") ?? "visitante";
this.textContent = `👋 Hola, ${nombre}`;
}
}
customElements.define("saludo-usuario", SaludoUsuario);
document.body.innerHTML = `
<saludo-usuario nombre="Ana"></saludo-usuario>
<p><saludo-usuario></saludo-usuario></p>`;
console.log(document.querySelectorAll("saludo-usuario").length);
- La clase extiende
HTMLElement. customElements.define(nombre, clase)la registra. El nombre lleva guion.- Los elementos que ya estaban en la página se “actualizan” al definirse; los que se agreguen después, también.
El ciclo de vida
| Método | Se llama cuando… |
|---|---|
constructor() |
Se crea el elemento. Llama a super() y no toques atributos ni hijos todavía. |
connectedCallback() |
Se agrega a la página. Lugar para armar el contenido y los listeners. |
disconnectedCallback() |
Se quita. Lugar para limpiar: temporizadores, listeners globales, observers. |
attributeChangedCallback(nombre, antes, ahora) |
Cambia un atributo declarado en static observedAttributes. |
class BarraProgreso extends HTMLElement {
static observedAttributes = ["valor"];
attributeChangedCallback(nombre, antes, ahora) {
this.style.cssText = `display:block; height:10px; background:#f7df1e; width:${Number(ahora)}%`;
console.log(`${nombre}: ${antes} → ${ahora}`);
}
}
customElements.define("barra-progreso", BarraProgreso);
const barra = document.createElement("barra-progreso");
document.body.append(barra);
barra.setAttribute("valor", 30);
barra.setAttribute("valor", 80);
Shadow DOM
El Shadow DOM le da al componente un DOM propio y encapsulado: sus estilos no se escapan a la página, y los de la página no lo rompen.
class Etiqueta extends HTMLElement {
connectedCallback() {
if (this.shadowRoot) return;
const raiz = this.attachShadow({ mode: "open" });
raiz.innerHTML = `
<style>
span { padding: 2px 10px; border-radius: 99px; background: #c4ec8c; color: #14201a; font: 600 13px system-ui; }
</style>
<span><slot>sin texto</slot></span>`;
}
}
customElements.define("mi-etiqueta", Etiqueta);
document.body.innerHTML = `
<style>span { color: red; }</style>
<mi-etiqueta>Nuevo</mi-etiqueta> <mi-etiqueta></mi-etiqueta> <span>un span de la página</span>`;
console.log(document.querySelector("mi-etiqueta").shadowRoot.querySelector("span").textContent.trim());
attachShadow({ mode: "open" })crea la raíz;this.shadowRootla devuelve.- Un
<slot>muestra el contenido que puso quien usa el componente (aquí, “Nuevo”), con un texto por defecto. - El
span { color: red }de la página no afecta al de adentro, y al revés. - Para dejar que la página personalice algo, usa propiedades personalizadas de CSS, que sí atraviesan el Shadow DOM, o
::part().
Plantillas
<template> guarda HTML que no se muestra ni se ejecuta hasta que lo clonas. Es la forma eficiente de crear muchas copias de la misma estructura:
document.body.innerHTML = `
<template id="fila"><li><strong></strong> <span></span></li></template>
<ul id="lista"></ul>`;
const plantilla = document.querySelector("#fila");
for (const [nombre, precio] of [["Té", 3], ["Café", 5]]) {
const copia = plantilla.content.cloneNode(true);
copia.querySelector("strong").textContent = nombre;
copia.querySelector("span").textContent = `S/ ${precio}`;
document.querySelector("#lista").append(copia);
}
console.log(document.querySelectorAll("#lista li").length);
Resumen
- Una clase que extiende
HTMLElement+customElements.define("con-guion", Clase). connectedCallbackarma,disconnectedCallbacklimpia,attributeChangedCallbackreacciona a los atributos deobservedAttributes.- Shadow DOM (
attachShadow) encapsula estructura y estilos;<slot>muestra el contenido de afuera. <template>guarda HTML para clonar.- Funcionan en cualquier página, con o sin framework.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Etiquetas propias
Resuelto
Elige una respuesta en cada pregunta.
¿Qué condición debe cumplir el nombre de un elemento personalizado?
¿Cuándo se llama a
connectedCallback?¿Qué aporta el Shadow DOM?
¿Qué hace falta para enterarse de que cambió un atributo?
Ordena la salida: El ciclo de vida de un elemento
Resuelto
Un elemento que avisa de cada momento de su vida. Ordena lo que aparecería en la consola.
1class MiCaja extends HTMLElement {2 static observedAttributes = ["color"];3 constructor() {4 super();5 console.log("constructor");6 }7 connectedCallback() {8 console.log("conectado");9 }10 attributeChangedCallback(nombre, antes, ahora) {11 console.log(`${nombre}: ${antes} → ${ahora}`);12 }13 disconnectedCallback() {14 console.log("desconectado");15 }16}17customElements.define("mi-caja", MiCaja);18 19const caja = document.createElement("mi-caja");20caja.setAttribute("color", "rojo");21document.body.append(caja);22caja.remove();Consola, de arriba abajo
- conectado
- constructor
- desconectado
- color: null → rojo
createElement construye el elemento. El atributo cambia antes de que esté en la página, y su valor anterior era null. Recién al agregarlo con append se llama a connectedCallback, y al quitarlo, a disconnectedCallback.
Detective: Un nombre sin guion
Resuelto
El componente no llega a registrarse. Encuentra la línea y elige el arreglo.
Consola
Uncaught SyntaxError: Failed to execute 'define' on 'CustomElementRegistry': "tarjeta" is not a valid custom element name
at tarjeta.js:7:16Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Un contador reutilizable
Resuelto
Define <contador-clics> con Shadow DOM. La página ya tiene dos: van a cobrar vida en cuanto los definas.
La página index.html
Consola del navegador
Lo que debe cumplir
- Los dos contadores muestran
Clics: 0yClics: 5(pendiente) - Cada clic suma uno, en su propio contador (pendiente)
- Funciona con contadores creados desde el código (pendiente)
Una solución
1class ContadorClics extends HTMLElement {2 connectedCallback() {3 if (this.shadowRoot) return; // por si se vuelve a conectar4 let n = Number(this.getAttribute("inicio") ?? 0);5 const raiz = this.attachShadow({ mode: "open" });6 const boton = document.createElement("button");7 boton.textContent = `Clics: ${n}`;8 boton.addEventListener("click", () => {9 n++;10 boton.textContent = `Clics: ${n}`;11 });12 raiz.append(boton);13 }14}15 16customElements.define("contador-clics", ContadorClics);Los elementos que ya estaban en la página se "actualizan" en cuanto se define la clase, y los que se crean después funcionan igual. Cada uno tiene su propio estado. Y como es una etiqueta de HTML, funciona en cualquier página o framework.