data-*
Des attributs personnalisés pour stocker des données destinées aux scripts et aux styles.
- S’applique à
- Tous les éléments HTML
Exemple
#<style>
[data-level="expert"] { color: #f472b6; }
li::after { content: " (" attr(data-points) " pts)"; color: #737373; }
</style>
<ul>
<li data-level="beginner" data-points="120">Anne</li>
<li data-level="expert" data-points="980">Jules</li>
</ul>Définition et utilisation
#Les attributs commençant par data- permettent d’ajouter à un élément vos propres informations, par exemple un identifiant de produit, l’état d’un bouton ou une catégorie. Le navigateur ne les interprète pas, ils sont destinés à votre code.
En JavaScript, vous les lisez via l’objet dataset. Le nom après data- est converti en camelCase : data-product-id devient element.dataset.productId. Les valeurs sont toujours des chaînes.
Vous pouvez aussi vous en servir pour le style en CSS, par exemple [data-state="active"], ou afficher la valeur avec content: attr(data-label).
Syntaxe
#<element data-nom="valeur">…</element>Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Ne stockez rien de secret dans
data-*. Tout le monde peut consulter le code de la page. - Écrivez les noms en minuscules avec des tirets, par exemple
data-user-id.
Entrées associées
#Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.