Window.customElements

La propriété en lecture seule customElements de l'interface Window renvoie une référence à l'objet CustomElementRegistry (en-US), qui peut être utilisée pour enregistrer de nouveaux éléments personnalisés et obtenir des informations sur des éléments personnalisés enregistrés.

Syntaxe

js
let registreElementsPersonnalises = window.customElements;

Valeur retournée

Une instance d'objet CustomElementRegistry (en-US) représentant le registre des éléments personnalisés pour la fenêtre en cours.

Exemples

L'exemple le plus courant d'utilisation de cette propriété que vous verrez sera d'obtenir l'accès à la méthode CustomElementRegistry.define() pour définir et enregistrer un nouvel élément personnalisé, par exemple :

js
let registreElementsPersonnalises = window.customElements;
registreElementsPersonnalises.define(
  "mon-element-personnalise",
  MonElementPersonnalise,
);

Cependant, il est généralement raccourci en quelque chose comme :

js
customElements.define(
  "details-element",
  class extends HTMLElement {
    constructor() {
      super();
      const modele = document.getElementById("modele-details-element").content;
      const racineOmbre = this.attachShadow({ mode: "open" }).appendChild(
        template.cloneNode(true),
      );
    }
  },
);

Voir notre repo web-components-examples pour davantage d'exemples d'utilisation.

Spécifications

Specification
HTML Standard
# dom-window-customelements

Compatibilité des navigateurs

BCD tables only load in the browser