Attribut global HTMLAttributs globaux

data-*

Des attributs personnalisés pour stocker des données destinées aux scripts et aux styles.

S’applique à
Tous les éléments HTML
Sur cette page

Exemple

#
HTML
<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>
Aperçu

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

#
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.