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.