Document.registerElement()

Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

Attention : document.registerElement() est déprécié en faveur de customElements.define() (en-US).

Brouillon: Cette page n'est pas terminée.

La méthode Document.registerElement() permet d'enregistrer un nouvel élément personnalisé (en-US) dans le navigateur, et retourne un constructeur pour ce nouvel élément.

Note : Il s'agit d'une technologie expérimentale. Le navigateur dans lequel vous l'utilisez doit être compatible avec les Composants Web. Voir Activer les Composants Web dans Firefox.

Syntaxe

var constructeur = document.registerElement(nom-tag, options);

Paramètres

nom-tag

Le nom de l'élément personnalisé. Le nom doit contenir un tiret (-), par exemple mon-tag.

options Facultatif

Un objet définissant le prototype sur lequel se base l'élément personnalisé, ainsi qu'un tag existant à étendre.

Exemple

Voici un exemple très simple :

var Montag = document.registerElement('mon-tag');

Le nouveau tag est désormais enregistré dans le navigateur. La variable Montag contient un constructeur que vous pouvez utiliser pour créer des éléments mon-tag dans le document de la façon suivante :

document.body.appendChild(new Montag());

Ceci insert un élément mon-tag vide qui sera visible si vous utilisez les outils de développement du navigateur. Il ne sera pas visible si vous utilisez la fonction de visualisation de la source du navigateur. Et il ne sera pas visible dans le navigateur tant que vous n'aurez pas ajouter du contenu au tag. Ce qui suit est un exemple d'ajout de contenu au nouveau tag :

var montag = document.getElementsByTagName("mon-tag")[0];
montag.textContent = "Je suis un élément mon-tag.";

Compatibilité avec les navigateurs

BCD tables only load in the browser

Voir aussi