CKTIS / JavaScript
Web Components: elementos personalizados y ciclo de vida
Los Web Components son mecanismos de la plataforma web para crear elementos de interfaz personalizados. Aprende a registrar una clase que extiende HTMLElement, responder a la conexión y desconexión, y observar atributos. Son API del navegador, no funciones proporcionadas por ECMAScript en sí.
Versión: Web-platform APIs, not tied to an ECMAScript edition. The example's exact console output was verified in isolated Chromium 157.0.8103.51 only; this does not establish broader browser compatibility. Node 24 in the repository does not establish browser API support.
Sintaxis
class ExampleElement extends HTMLElement {
static get observedAttributes() { return ['label']; }
connectedCallback() { /* initialize or resume */ }
disconnectedCallback() { /* release external resources */ }
attributeChangedCallback(name, oldValue, newValue) { /* react to an observed attribute */ }
}
customElements.define('example-element', ExampleElement);Los Web Components abarcan los elementos personalizados (custom elements), Shadow DOM y las plantillas y slots. Estos mecanismos se pueden combinar, pero un elemento personalizado no necesita Shadow DOM. Un elemento personalizado autónomo es una instancia de una clase que extiende HTMLElement. customElements.define() registra el constructor de esa clase con el nombre del elemento. Un nombre válido debe contener un guion, como cktis-greeting.
En el constructor, llama a super() antes de usar this; allí se puede crear un shadow root con attachShadow(). connectedCallback() gestiona la conexión al documento, mientras que disconnectedCallback() gestiona la desconexión. La conexión puede producirse varias veces: evita duplicar listeners o temporizadores y libera los recursos externos al desconectar. Shadow DOM encapsula la estructura y los estilos, pero no es una frontera de seguridad.
observedAttributes, que es estático, especifica los nombres de los atributos observados. attributeChangedCallback(name, oldValue, newValue) responde a su incorporación, cambio o eliminación; puede ejecutarse antes de que el elemento esté conectado. Un valor ausente se representa con null. Cambiar una propiedad normal de JavaScript no cambia automáticamente un atributo. El ejemplo usa textContent para mostrar texto sin interpretarlo como HTML.
Las fuentes citadas se centran en los elementos personalizados y en HTMLElement: el estándar HTML de WHATWG define los elementos personalizados, y la documentación de MDN describe HTMLElement y explica cómo usar los elementos personalizados. La salida exacta del ejemplo en la consola se verificó únicamente en una instancia aislada de Chromium 157.0.8103.51. Esto no demuestra la compatibilidad con otros navegadores o versiones; comprueba si los navegadores de destino admiten estas API. Ninguna edición de ECMAScript garantiza por sí sola Web Components; Node 24 en el repositorio tampoco demuestra que estas API estén disponibles. El ejemplo requiere un entorno de navegador.
Ejemplos
(() => {
class CktisGreeting extends HTMLElement {
static get observedAttributes() {
return ['label'];
}
constructor() {
super();
this.attachShadow({ mode: 'open' });
}
connectedCallback() {
this.render();
}
disconnectedCallback() {
console.log('disconnected');
}
attributeChangedCallback(name, oldValue, newValue) {
if (oldValue !== newValue) this.render();
}
render() {
this.shadowRoot.textContent = `Hello, ${this.getAttribute('label') ?? 'world'}!`;
}
}
if (customElements.get('cktis-greeting')) {
throw new Error('Reload the page before running this example again.');
}
customElements.define('cktis-greeting', CktisGreeting);
const element = document.createElement('cktis-greeting');
document.body.append(element);
console.log(element.shadowRoot.textContent);
element.setAttribute('label', 'Ada');
console.log(element.shadowRoot.textContent);
element.remove();
})();Resultado
Hello, world! Hello, Ada! disconnected
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.