Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Constructeur HTMLElement

`HTMLElement` est la classe de base des éléments personnalisés autonomes. Son constructeur s’appelle via `super()` dans une sous-classe, et non directement avec `new HTMLElement()`.

Version : Current web platform; runtime support varies

Syntaxe

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

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

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

Le constructeur HTMLElement appartient à une interface de la plateforme web exposée sur Window, et non aux objets natifs d’ECMAScript. La syntaxe des classes date d’ECMAScript 2015, mais c’est le navigateur qui fournit l’algorithme de construction des éléments HTML et le registre des éléments personnalisés. new HTMLElement() et HTMLElement() lèvent tous deux une TypeError. Pour créer un élément HTML ordinaire, utilisez document.createElement("div").

Pour définir un élément personnalisé autonome, écrivez une classe avec extends HTMLElement et enregistrez-la via customElements.define() sous un nom valide contenant un trait d’union. Si vous écrivez un constructor, placez d’abord super() sans argument, avant tout usage de this. JavaScript transmet new.target au constructeur de base ; la plateforme retrouve la définition par l’identité du constructeur, et non par un nom transmis à super(). Avec new sur une sous-classe non enregistrée, l’appel à super() lève une TypeError.

Après l’enregistrement, new StatusBadge() et document.createElement("cktis-status-badge") créent chacun une nouvelle instance dans l’espace de noms HTML, sans l’insérer dans le document. Lorsqu’un élément existant est mis à niveau vers la classe enregistrée, super() rend ce même nœud accessible via this. Initialisez l’état de l’instance dans le constructeur, sans y lire ni ajouter d’attributs ou de nœuds enfants. Placez les opérations qui exigent que l’élément soit connecté dans connectedCallback(), qui peut s’exécuter plusieurs fois.

Un élément natif personnalisé exige l’interface correspondante, par exemple HTMLButtonElement, et l’option d’enregistrement { extends: "button" }. La prise en charge dépend de l’environnement : la conformité à ECMAScript seule ne fournit pas ces API du DOM, et la prise en charge des éléments autonomes ne garantit pas celle des éléments natifs personnalisés.

Exemples

<!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>

Résultat

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

Les deux premières lignes montrent l’échec de la construction directe et celui de la construction de la sous-classe avant son enregistrement. Ensuite, les deux méthodes produisent une instance de `StatusBadge` qui a le statut `ready` et qui n’est pas encore connectée au document (`false`). Rechargez la page de l’exemple dans le navigateur pour le réexécuter.

Leçons associées

  • JavaScript · Leçon 38 · Intermédiaire · Version : 3
  • JavaScript · Leçon 39 · Intermédiaire · Version : 3

Sources