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

CKTIS / JavaScript

Web Components : éléments personnalisés et cycle de vie

Les Web Components sont des mécanismes de la plateforme Web permettant de créer des éléments d’interface personnalisés. Découvrez comment enregistrer une classe qui étend HTMLElement, réagir à la connexion et à la déconnexion, et observer des attributs. Il s’agit d’API du navigateur, et non de fonctionnalités fournies par ECMAScript lui-même.

Version : 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.

Syntaxe

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);

Les Web Components regroupent les éléments personnalisés (custom elements), le Shadow DOM, ainsi que les modèles et les slots. Ces mécanismes peuvent être combinés, mais un élément personnalisé n’a pas besoin du Shadow DOM. Un élément personnalisé autonome est une instance d’une classe qui étend HTMLElement. customElements.define() enregistre le constructeur de cette classe sous le nom de l’élément. Un nom valide doit contenir un trait d’union, comme cktis-greeting.

Dans le constructeur, appelez super() avant d’utiliser this ; un shadow root peut y être créé avec attachShadow(). connectedCallback() gère la connexion au document, tandis que disconnectedCallback() gère la déconnexion. La connexion peut se produire plusieurs fois : évitez de dupliquer les écouteurs ou les minuteries et libérez les ressources externes lors de la déconnexion. Le Shadow DOM encapsule la structure et les styles, mais ne constitue pas une frontière de sécurité.

La propriété statique observedAttributes indique les noms des attributs observés. attributeChangedCallback(name, oldValue, newValue) réagit à leur ajout, modification ou suppression ; il peut être appelé avant la connexion de l’élément. Une valeur absente est représentée par null. Modifier une propriété JavaScript ordinaire ne modifie pas automatiquement un attribut. L’exemple utilise textContent pour afficher du texte sans l’interpréter comme du HTML.

Les sources citées portent sur les éléments personnalisés et HTMLElement : le standard HTML du WHATWG définit les éléments personnalisés, tandis que la documentation MDN décrit HTMLElement et explique comment utiliser les éléments personnalisés. La sortie exacte de l’exemple dans la console a été vérifiée uniquement dans une instance isolée de Chromium 157.0.8103.51. Cela n’établit pas la compatibilité avec d’autres navigateurs ou versions ; vérifiez la prise en charge de ces API dans les navigateurs ciblés. Aucune édition d’ECMAScript ne garantit à elle seule les Web Components ; la présence de Node 24 dans le dépôt ne prouve pas non plus la disponibilité des API. L’exemple nécessite un environnement de navigateur.

Exemples

(() => {
  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();
})();

Résultat

Hello, world!
Hello, Ada!
disconnected

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources