CKTIS / JavaScript
Element : classes, contenu et présence d’un attribut
Utilisez `className` pour lire ou remplacer la chaîne de classes, `innerHTML` pour lire ou remplacer le contenu sous forme de balisage et `toggleAttribute()` pour modifier la présence d’un attribut.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)Il s’agit d’API du DOM, et non de fonctionnalités d’ECMAScript 2024. La version d’ECMAScript indiquée dans cette fiche ne détermine pas leur disponibilité. L’environnement d’exécution doit fournir les API DOM correspondantes ; leur disponibilité dépend de cet environnement.
Sur un élément HTML, className reflète l’attribut class sous forme d’une chaîne de noms de classes séparés par des caractères d’espacement. Une affectation remplace toute la chaîne. Pour modifier une seule classe sans toucher aux autres, utilisez classList. Sur un élément SVG, className peut être un SVGAnimatedString ; utilisez getAttribute('class') ou setAttribute('class', value) pour accéder directement à l’attribut.
En lecture, innerHTML renvoie le contenu sous forme de balisage HTML ou XML, sans l’élément lui-même ni sa racine d’ombre. En écriture, la propriété analyse le balisage dans le contexte de l’élément et remplace les nœuds du contenu au lieu d’en ajouter à la suite. Sur un élément template, elle remplace le contenu du modèle. Les écouteurs d’événements restent sur les anciens nœuds et ne sont pas transférés aux nouveaux. Dans un document XML, un balisage mal formé peut déclencher SyntaxError en écriture, et un échec de sérialisation peut déclencher InvalidStateError en lecture.
Ne transmettez pas directement de balisage non fiable à innerHTML : la propriété ne l’assainit pas par défaut, d’où un risque de XSS. Utilisez textContent pour afficher du texte brut dans des éléments comme span. N’affectez toutefois pas de texte non fiable à textContent sur un élément script : ce texte peut être exécuté comme du code lorsque l’élément est inséré dans le document. Si du balisage est nécessaire, assainissez l’entrée non fiable avant l’insertion. Si la CSP impose Trusted Types et qu’aucune politique par défaut n’est définie, affecter une chaîne ordinaire déclenche TypeError ; utilisez un TrustedHTML issu d’une politique adaptée.
toggleAttribute(name) supprime un attribut présent ou ajoute un attribut absent avec une valeur vide. Avec force, true garantit sa présence sans modifier une valeur existante et false garantit son absence. Le booléen renvoyé indique si l’attribut est présent après l’appel, et non si quelque chose a changé. Pour un attribut booléen HTML comme disabled, même la valeur "false" ne le désactive pas : seule la présence compte. Sur un élément HTML dans un document HTML, les lettres ASCII du nom passent en minuscules ; un nom invalide déclenche InvalidCharacterError.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element DOM example</title>
</head>
<body>
<script>
(() => {
const button = document.createElement('button');
button.className = 'action muted';
button.className = 'action ready';
button.innerHTML = '<span>Draft</span>';
const oldLabel = button.firstElementChild;
button.innerHTML = '<strong>Save</strong>';
console.log(button.className);
console.log(button.innerHTML);
console.log(oldLabel.parentNode === null);
console.log(button.toggleAttribute('disabled'));
console.log(button.toggleAttribute('disabled', true));
console.log(button.toggleAttribute('disabled', false));
})();
</script>
</body>
</html>Résultat
action ready <strong>Save</strong> true true true false
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur qui n’impose pas Trusted Types et consultez la console de développement. Le bouton n’est pas ajouté au document. Le premier `true` confirme que l’ancien nœud du libellé a été détaché ; les trois derniers résultats montrent l’état de `disabled` après son ajout, la garantie de sa présence, puis sa suppression.
Leçons associées
- JavaScript · Leçon 39 · Intermédiaire · Version : 3