Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

document.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 Document.createAttribute() crée un nouveau nœud d'attribut et le renvoie. L'objet a créé un noeud 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 dans le paramètre est convertie en minuscules.

Syntaxe

js
attribut = document.createAttribute(nom);

Paramètres

  • nom est une chaîne de caractères contenant le nom de l'attribut.

Valeur de retour

Un nœud Attr.

Exceptions levées

  • INVALID_CHARACTER_ERR si le paramètre contient un caractère invalide pour un attribut XML.

Exemples

js
var node = document.getElementById("div1");
var a = document.createAttribute("my_attrib");
a.value = "newVal";
node.setAttributeNode(a);
console.log(node.getAttribute("my_attrib")); // "newVal"

Spécifications

Specification
DOM
# dom-document-createattribute

Compatibilité des navigateurs

Voir aussi