Document : méthode createAttribute()

Baseline Large disponibilité

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.

En savoir plus
Voir la compatibilité complète

La méthode createAttribute() de l'interface Document crée un nouveau nœud d'attribut. 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(localName)

Paramètres

localName: Une chaîne de caractères contenant le nom de l'attribut. La valeur est utilisée pour initialiser la propriété localName du nouvel attribut.

Valeur de retour

Un nœud Attr.

Exceptions levées

InvalidCharacterError DOMException: Levée si la valeur de localName n'est pas un nom d'attribut valide. Elle doit contenir au moins un caractère et ne peut pas contenir d'espaces ASCII, NULL, /, = ou > (U+0000, U+002F, U+003D ou U+003E, respectivement).

Note : Les versions antérieures de la spécification étaient plus restrictives, exigeant que le localName soit un nom XML ^(angl.) valide.

Exemples

Exemple simple

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

Spécification
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()

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 1 août 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu