Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

Document.registerElement()

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

Spécifications

Spécification Status Commentaire
Custom Elements Version de travail Initial definition

Compatibilité avec les navigateurs

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.

Étiquettes et contributeurs liés au document

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