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.

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

Brouillon
Cette page n'est pas terminée.

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.

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

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 35 31[1] Pas de support 25 Pas de support
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 4.4.4 31[1] Pas de support 25 Pas de support

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

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : loella16, gsavin
Dernière mise à jour par : loella16,