Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

<frequency>

Le type de données CSS <frequency> permet de représenter des fréquences (par exemple la hauteur d'une voie). Une valeur de type <frequency> se compose d'une valeur <number> suivi immédiatement d'une unité de fréquence. Comme pour les autres dimensions CSS, il n'y a pas d'espace entre le nombre et le littéral de l'unité.

Voici les différentes unités qui peuvent être utilisées :

  • Hz permet de représenter des fréquences exprimées en Hertz (par exemple 0Hz, 1500Hz, 10000Hz)
  • kHz permet de représenter des fréquences exprimées en kilohertz (par exemple 0kHz, 1.5kHz, 10kHz).

Bien que la valeur nulle puisse être représentée avec le même littéral pour les deux unités, l'unité ne doit pas être absente sinon la valeur sera interprétée comme une valeur de longueur (type length) et ne représentera ni 0Hz ni 0kHz. Bien que les unités CSS soient insensibles à la casse, c'est une bonne pratique que d'utiliser un H majuscule pour Hz et kHz car selon le système international, Hertz est un nom de famille.

Exemples

Valeurs de fréquences valides
Code Signification
12Hz Un entier positif.
-456kHz Un entier négatif.
4.3Hz Une valeur décimale.
14KhZ L'unité est insensible à la casse bien que cette capitalisation ne soit pas recommandée.
+0Hz Un zéro précédé d'un + et suivi de l'unité.
-0kHz Un zéro précédé d'un - et suivi de l'unité.
Code Signification
Valeurs de fréquences invalides
12.0 Cette valeur est une valeur de type <number>, et pas de type <frequency> car elle n'a aucune unité.
7 Hz Il ne doit pas y avoir d'espace entre le littéral de type <number> et l'unité.
0 Les valeurs nulles ne doivent pas être écrites sans unité car elles sont interprétées comme des valeurs de type <length> et non comme des valeurs de type <frequency>.

Spécifications

Spécification État Commentaires
CSS Values and Units Module Level 3
La définition de '<frequency>' dans cette spécification.
Candidat au statut de recommandation Définition initiale.

Ce type de donnés fut initialement introduit avec la spécification CSS Niveau 2 pour le groupe de média aural qui est désormais obsolète. Ce type de données a donc été déprécié puis réintroduit avec CSS3 bien qu'aucune propriété ne l'utilise à l'heure actuelle.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple Pas de support Pas de support Pas de support Pas de support[1] Pas de support
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple Pas de support Pas de support Pas de support Pas de support Pas de support

[1] Certaines versions d'Opera ont une prise en charge partielle du groupe de média obsolète « aural media » et, à ce titre, prend en charge le type de données <frequency> pour la propriété de hauteur du son.

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : SphinxKnight, Sebastianz, Prinz_Rana, fscholz, teoli, FredB, Goofy
 Dernière mise à jour par : SphinxKnight,