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

CKTIS / HTML

data-* : les attributs propres à l’application

Stockez un état textuel sans le considérer comme fiable ou secret.

Version : HTML Living Standard

Syntaxe

<button data-item-count="2">Add</button>

Les attributs personnalisés data-* conservent des informations pour l’application de la page. Ajoutez un nom après le préfixe, de préférence en minuscules avec tirets. L’interface dataset transforme par exemple data-item-count en propriété camelCase itemCount. La lecture renvoie du texte, même si l’attribut contient des chiffres.

Convertissez et validez avant tout calcul ou décision métier. Modifier une propriété dataset met à jour l’attribut associé ; les valeurs deviennent des chaînes. Ces données sont visibles et modifiables par l’utilisateur : ni secrets ni autorisations serveur n’y ont leur place. Préférez un attribut standard existant lorsqu’il exprime déjà le sens voulu.

Le bouton commence avec le compteur deux. Son gestionnaire convertit explicitement le texte en nombre, l’incrémente puis le réécrit. Le résultat contrôle dataset et l’attribut synchronisé, sans concaténation accidentelle de chaînes.

Exemples

<!doctype html><meta charset="utf-8">
<button id="add" data-item-count="2">Add</button><output id="result"></output><script>
const button = document.querySelector('#add'), beforeType = typeof button.dataset.itemCount;
button.addEventListener('click', () => { button.dataset.itemCount = String(Number(button.dataset.itemCount) + 1); });
button.click();
document.querySelector('#result').textContent = 'beforeType=' + beforeType + '; after=' + button.dataset.itemCount + '; attribute=' + button.getAttribute('data-item-count');
</script>

Résultat

beforeType=string; after=3; attribute=3

La conversion est explicite ; l’attribut ne rend pas sa valeur numérique à lui seul.

Sources