Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Element.setAttribute — définir un attribut

Element.setAttribute prend le nom et la valeur d’un attribut d’un élément du DOM. Si l’appel réussit, la méthode ajoute l’attribut ou remplace sa valeur.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

element.setAttribute(qualifiedName, value)

Si l’appel à element.setAttribute(qualifiedName, value) réussit, la méthode crée l’attribut s’il est absent ou met à jour le premier attribut portant ce nom. Il s’agit d’une méthode du DOM, et non d’une fonction d’ECMAScript lui-même.

Quand la politique de sécurité du contenu (CSP) impose l’utilisation de Trusted Types, passer une simple chaîne comme valeur d’un attribut protégé tel que onclick peut déclencher une exception TypeError sans que l’attribut soit créé ou mis à jour.

Pour les éléments de l’espace de noms HTML appartenant à un document HTML, le nom est converti en minuscules ASCII. Un nom invalide déclenche une DOMException de type InvalidCharacterError. Utilisez setAttributeNS pour définir des attributs avec un espace de noms spécifié.

Exemples

const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));

Résultat

ready

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte. L’exemple avec `data-state` ne montre pas l’effet de l’obligation d’utiliser Trusted Types sur un attribut protégé.

Sources