Document : méthode createAttribute()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode createAttribute() de l'interface Document crée un nouveau nœud d'attribut et le renvoie. L'objet créé est un nœud implémentant l'interface Attr. Le DOM n'impose pas le type d'attribut à ajouter à un élément particulier de cette manière.
Note : La chaîne de caractères donnée en paramètre est convertie en minuscules.
Syntaxe
createAttribute(name)
Paramètres
name-
Une chaîne de caractères contenant le nom de l'attribut.
Valeur de retour
Un nœud Attr.
Exceptions levées
InvalidCharacterErrorDOMException-
Levée si la valeur de
namen'est pas un nom XML (angl.) valide ; par exemple, si elle commence par un chiffre, un tiret ou un point, ou contient des caractères autres que des caractères alphanumériques, des tirets bas (_), des tirets (-) ou des points (.).
Exemples
const noeud = document.getElementById("div1");
const a = document.createAttribute("mon_attribut");
a.value = "nouvelleValeur";
noeud.setAttributeNode(a);
console.log(noeud.getAttribute("mon_attribut")); // "nouvelleValeur"
Spécifications
| Specification |
|---|
| DOM # dom-document-createattribute |
Compatibilité des navigateurs
Voir aussi
- La méthode
Document.createAttributeNS() - La méthode
Document.createElement() - La méthode
Element.setAttribute() - La méthode
Element.setAttributeNode()