<meter>

Ajouté dans HTML5

Résumé

L'élément HTML <meter> représente une mesure scalaire dans un intervalle connu, ou une proportion connue. Cela peut être par exemple l'utilisation d'un disque, la pertinence du résultat d'une requête ou la proportion de votants ayant choisi un candidat spécifique.

Notes d'utilisation :

  • l'élément <meter> ne doit pas être utilisé pour représenter une barre de progression. L'élément <progress> doit être utilisé dans ce cas.
  • Sauf si l'attribut value est compris entre 0 et 1 (au sens large), les attributs min et max doivent définir un intervalle auquel appartient la valeur de l'attribut value.

Attributs

form
Cet attribut contient l'attribut id de l'élément <form> auquel celui-ci est rattaché. Par défaut, il est à l'élément <form> qui est son plus proche ancêtre.
high
Cet attribut représente la valeur minimale à partir de laquelle la mesure est considérée comme haute. Si cet attribut est défini, il doit s'agir d'un nombre à virgule compris entre les valeurs des attributs min et max. Si l'attribut low est aussi défini, il doit être plus grand que celui-ci.
low
Cet attribut représente la valeur maximale à partir de laquelle la mesure est considérée comme basse. Si cet attribut est défini, il doit s'agir d'un nombre à virgule compris entre les valeurs des attributs min et max. Si l'attribut high est aussi défini, il doit être plus petit que celui-ci.
max
Cet attribut représente la valeur maximale que peut prendre la mesure. Il doit s'agir d'un nombre à virgule; s'il est invalide ou si l'attribut n'est pas défini, sa valeur par défaut est 1.0. Il doit être strictement plus grand que la valeur de l'attribut min.
min
Cet attribut représente la valeur minimale que peut prendre la mesure. Il doit s'agir d'un nombre à virgule; s'il est invalide ou si l'attribut n'est pas défini, sa valeur par défaut est 0.0. Il doit être strictement plus petit que la valeur de l'attribut max.
optimum
Cet attribut représente la valeur idéale pour la mesure. Si cet attribut est défini, il doit s'agir d'un nombre à virgule compris entre les valeurs des attributs min et max. Si la valeur de optimum est inférieure à low, s'il est défini, cela signifie que les valeurs les plus petites sont meilleures; si sa valeur est supérieure à high, s'il est défini, cela signifie que les valeurs les plus grandes sont meilleures; enfin, s'il est compris entre low et high, cela signifie que les extrêmes ne sont pas les meilleures grandeurs.
value
Cette attribut représente la valeur courante de la mesure. Cet attribut est obligatoire.

Note d'utilisation : il est recommandé aux auteurs de dupliquer les valeurs des attributs min, max et value dans le contenu de cet élément de façon à permettre aux navigateurs ne supportant pas l'élément <meter> de transmettre ces informations aux utilisateurs. Par exemple :

Utilisation de l'espace de stockage: <meter value=6 max=8>6 blocs utilisés (sur un total de 8)</meter>
Il n'y a pas de moyen sémantique de décrire l'unité de l'attribut value, néanmoins l'attribut global title peut être utilisé pour cela.

Exemples

Exemple simple

<p>Chauffer le four à <meter min="200" max="500" value="350">350 degrés</meter>.</p>

Le résultat sera :

Chauffer le four à

350 degrés

Exemple utilisant les attribut low et high

Il faut remarquer l'absence de l'attribut min. Cela est autorisé car il prendra alors la valeur par défaut (0).

<p>Il a reçu <meter low="69" high="80" max="100" value="80">16</meter> à l'examen.</p>

Le résultat produit sera :

Il a reçu

16

à l'examen.

Spécifications

Spécification Statut Commentaires
WHATWG HTML Living Standard Living Standard  
HTML5 Candidate Recommendation  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 6.0 16.0 (16.0) bug 555985 10.0 11.0 5.2
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple Pas de support 16.0 (16.0) bug 555985 Pas de support 11.0 Pas de support

Voir également

Étiquettes et contributeurs liés au document

Contributeurs ayant participé à cette page : tregagnon, SphinxKnight, teoli
Dernière mise à jour par : tregagnon,