Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Constructor de HTMLElement

`HTMLElement` es la clase base de los elementos personalizados autónomos. Su constructor se invoca con `super()` en una subclase, no directamente con `new HTMLElement()`.

Versión: Current web platform; runtime support varies

Sintaxis

class StatusBadge extends HTMLElement {
  constructor() {
    super();
    // Initialize instance state here.
  }
}

customElements.define("cktis-status-badge", StatusBadge);

new StatusBadge();
document.createElement("cktis-status-badge");

El constructor de HTMLElement pertenece a una interfaz de la plataforma web expuesta en Window; no es un componente integrado de ECMAScript. La sintaxis de clases se introdujo en ECMAScript 2015, pero el navegador proporciona el algoritmo de construcción de elementos HTML y el registro de elementos personalizados. Tanto new HTMLElement() como HTMLElement() lanzan un TypeError. Para crear un elemento HTML normal, usa document.createElement("div").

Para definir un elemento personalizado autónomo, escribe una clase con extends HTMLElement y regístrala con customElements.define() usando un nombre válido que contenga un guion. Si escribes un constructor, la primera instrucción debe ser super() sin argumentos, antes de usar this. JavaScript transmite new.target al constructor base y la plataforma busca la definición por la identidad del constructor, no por un nombre pasado a super(). Usar new con una subclase sin registrar lanza un TypeError al llegar a super().

Tras el registro, new StatusBadge() y document.createElement("cktis-status-badge") crean cada uno una instancia nueva en el espacio de nombres HTML sin insertarla en el documento. Cuando un elemento existente se actualiza a la clase registrada, super() deja disponible ese mismo nodo como this. Usa el constructor para inicializar el estado de la instancia, sin leer ni añadir atributos ni nodos hijos. Deja para connectedCallback() las tareas que requieren que el elemento esté conectado; esta función puede ejecutarse más de una vez.

Un elemento integrado personalizado requiere la interfaz correspondiente, como HTMLButtonElement, y la opción de registro { extends: "button" }. La compatibilidad varía según el entorno: cumplir con ECMAScript no basta para disponer de estas API del DOM, y admitir elementos autónomos no implica admitir elementos integrados personalizados.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>HTMLElement constructor</title>
<script>
{
  class StatusBadge extends HTMLElement {
    constructor() {
      super();
      this.status = "ready";
    }
  }

  for (const create of [() => new HTMLElement(), () => new StatusBadge()]) {
    try {
      create();
    } catch (error) {
      console.log(error.name);
    }
  }

  customElements.define("cktis-status-badge", StatusBadge);

  for (const badge of [new StatusBadge(), document.createElement("cktis-status-badge")]) {
    console.log(`${badge.localName} ${badge instanceof StatusBadge} ${badge.status} ${badge.isConnected}`);
  }
}
</script>

Resultado

TypeError
TypeError
cktis-status-badge true ready false
cktis-status-badge true ready false

Las dos primeras líneas muestran que fallan tanto la construcción directa como la de la subclase antes de registrarla. Tras el registro, ambos métodos devuelven una instancia de `StatusBadge` con el estado `ready` que aún no está conectada al documento (`false`). Recarga la página del ejemplo en el navegador para volver a ejecutarlo.

Lecciones relacionadas

  • JavaScript · Lección 38 · Intermedio · Versión: 3
  • JavaScript · Lección 39 · Intermedio · Versión: 3

Fuentes