Document : méthode createAttributeNS()
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 createAttributeNS() de l'interface Document crée un nouveau nœud d'attribut avec l'URI de l'espace de noms et le nom qualifié définis, et le retourne. 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.
Syntaxe
createAttributeNS(namespaceURI, qualifiedName)
Paramètres
namespaceURI-
Une chaîne de caractères qui définit le
namespaceURIà associer à l'attribut. Certains URI d'espace de noms importants sont : qualifiedName-
Une chaîne de caractères qui définit le nom de l'attribut à créer. La propriété
namede l'attribut créé est initialisée avec la valeur dequalifiedName.
Valeur de retour
Le nouveau nœud Attr.
Exceptions
NamespaceErrorDOMException-
Levée si la valeur de
namespaceURIn'est pas un URI d'espace de noms valide. InvalidCharacterErrorDOMException-
Levée si la valeur de
qualifiedNamen'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("svg");
const a = document.createAttributeNS("http://www.w3.org/2000/svg", "viewBox");
a.value = "0 0 100 100";
noeud.setAttributeNode(a);
console.log(noeud.getAttribute("viewBox")); // "0 0 100 100"
Spécifications
| Specification |
|---|
| DOM # dom-document-createattributens |
Compatibilité des navigateurs
Voir aussi
- La méthode
Document.createAttribute() - La méthode
Document.createElementNS() - La méthode
Element.setAttributeNS() - La méthode
Element.setAttributeNode() - La méthode
Element.setAttributeNodeNS()