Saltar al contenido
JavaScript en el navegador

Web Components

Lección 12 de 1412 min4 ejercicios

¿Y si pudieras escribir <selector-fecha> o <tarjeta-producto> en tu HTML, como si fueran etiquetas del navegador? Los Web Components lo permiten, sin frameworks: defines la etiqueta con una clase, y funciona en cualquier página, con cualquier librería o sin ninguna.

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.shadowRoot la 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).
  • connectedCallback arma, disconnectedCallback limpia, attributeChangedCallback reacciona a los atributos de observedAttributes.
  • 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

Elige una respuesta en cada pregunta.

  1. ¿Qué condición debe cumplir el nombre de un elemento personalizado?

  2. ¿Cuándo se llama a connectedCallback?

  3. ¿Qué aporta el Shadow DOM?

  4. ¿Qué hace falta para enterarse de que cambió un atributo?

Ordena la salida: El ciclo de vida de un elemento

Un elemento que avisa de cada momento de su vida. Ordena lo que aparecería en la consola.

class MiCaja extends HTMLElement {  static observedAttributes = ["color"];  constructor() {    super();    console.log("constructor");  }  connectedCallback() {    console.log("conectado");  }  attributeChangedCallback(nombre, antes, ahora) {    console.log(`${nombre}: ${antes} → ${ahora}`);  }  disconnectedCallback() {    console.log("desconectado");  }}customElements.define("mi-caja", MiCaja); const caja = document.createElement("mi-caja");caja.setAttribute("color", "rojo");document.body.append(caja);caja.remove();

Consola, de arriba abajo

  1. conectado
  2. constructor
  3. desconectado
  4. color: null → rojo

Detective: Un nombre sin guion

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:16

Paso 1: toca la línea de código que causa el error.

Laboratorio: Un contador reutilizable

Define <contador-clics> con Shadow DOM. La página ya tiene dos: van a cobrar vida en cuanto los definas.

app.jsse ejecuta mientras escribes

La página index.html

Consola del navegador

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Los dos contadores muestran Clics: 0 y Clics: 5 (pendiente)
  • Cada clic suma uno, en su propio contador (pendiente)
  • Funciona con contadores creados desde el código (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.