Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : propriété customElementRegistry

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Want more browser support for this feature? Tell us why.

La propriété en lecture seule customElementRegistry de l'interface Element retourne l'objet CustomElementRegistry associé à cet élément, ou null si aucun n'a été défini.

La propriété customElementRegistry d'un élément est définie lorsque l'élément est créé (par exemple avec Document.createElement() avec l'option customElementRegistry, ou lorsqu'il est analysé dans un contexte ayant un registre local). Une fois définie sur un objet CustomElementRegistry, elle ne peut pas être modifiée. Le registre détermine quelles définitions de éléments personnalisés sont utilisées lorsque l'élément est mis à niveau.

Valeur

Un objet CustomElementRegistry, ou null.

Exemples

Accéder au registre d'éléments personnalisés d'un élément

Cet exemple crée un registre local, l'attache à une racine d'ombre, puis lit la propriété customElementRegistry d'un élément à l'intérieur de l'arbre d'ombre pour confirmer qu'elle correspond au registre local.

js
const monRegistre = new CustomElementRegistry();
monRegistre.define(
  "mon-element",
  class extends HTMLElement {
    connectedCallback() {
      this.textContent = "Bonjour depuis le registre local !";
    }
  },
);

const hote = document.createElement("div");
document.body.appendChild(hote);
const ombre = hote.attachShadow({
  mode: "open",
  customElementRegistry: monRegistre,
});
ombre.innerHTML = "<mon-element></mon-element>";

const el = ombre.querySelector("mon-element");
console.log(el.customElementRegistry === monRegistre); // true

Spécifications

Spécification
DOM
# dom-element-customelementregistry

Compatibilité des navigateurs

Voir aussi