Element : méthode setAttributeNS()

Syntaxe

setAttributeNS(namespaceURI, qualifiedName, value)

Paramètres

namespaceURI

Une chaîne de caractères définissant l'espace de noms de l'attribut à définir, ou la chaîne de caractères vide.

qualifiedName

Une chaîne de caractères identifiant l'attribut par son nom qualifié, qui a le format prefix:localName ou localName, où les parties sont définies comme suit :

prefix

Un « alias court » pour l'espace de noms. Le préfixe est facultatif, mais s'il est défini, le paramètre namespaceURI doit également être défini. Si le préfixe est défini sur xml ou xmlns, le namespaceURI doit être défini respectivement sur http://www.w3.org/XML/1998/namespace ou http://www.w3.org/2000/xmlns/.

localName

Le nom local de l'attribut.

value

Une chaîne de caractères ou un type de confiance contenant la valeur à attribuer à l'attribut.

Des instances de type de confiance doivent être passées pour les attributs suivants lorsque les types de confiance sont appliqués :

• Les attributs de contenu des gestionnaires d'évènements, tels que onclick et onload, nécessitent un TrustedScript.
• HTMLIFrameElement.srcdoc nécessite une instance de TrustedHTML.
• HTMLScriptElement.src nécessite une instance de TrustedScriptURL.
• SVGScriptElement.href nécessite une instance de TrustedScriptURL.

Les types de confiance ne sont pas appliqués pour les autres attributs, donc une chaîne de caractères ou tout type de confiance peut être passé.

Valeur de retour

Aucune (undefined).

Exceptions

NamespaceError DOMException

Levée si la valeur de namespaceURI est :

• n'est pas un URI d'espace de noms valide.
• définie sur la chaîne de caractères vide lorsque prefix a une valeur.
• n'est pas la valeur http://www.w3.org/XML/1998/namespace ou http://www.w3.org/2000/xmlns/ lorsque prefix est défini sur xml ou xmlns, respectivement.

InvalidCharacterError DOMException

Levée si l'un des prefix ou localName n'est pas valide :

• Le prefix doit contenir au moins un caractère et ne peut pas contenir d'espaces ASCII, NULL, / ou > (U+0000, U+002F ou U+003E, respectivement).
• Le localName 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 qualifiedName soit un nom XML ^(angl.) valide.

TypeError

Levée si value est passée une chaîne de caractères au lieu d'un objet de type de confiance (pour les attributs qui les nécessitent) lorsque les types de confiance sont appliqués par une CSP et qu'aucune politique par défaut n'est définie.

Exemples

Utilisation simple

let d = document.getElementById("d1");
d.setAttributeNS(
  "http://www.mozilla.org/ns/specialspace",
  "spec:align",
  "center",
);

Types de confiance

L'exemple Définir des attributs non sécurisés dans setAttribute() montre comment vous pouvez utiliser setAttributeNS() avec les types de confiance.

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode Element.hasAttributeNS()
• La méthode Element.getAttributeNS()
• La méthode Element.removeAttributeNS()
• La méthode Element.setAttribute()