Document.registerElement()

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

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.";

Spécifications

Compatibilité avec les navigateurs

[1] Cette API est implantée mais doit être activée dans les préférences.