Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

<frequency>

Le type de donnée CSS <frequency> permet de représenter des fréquences (par exemple la hauteur d'une voix). Ce type n'est actuellement utilisé pour aucune propriété CSS.

Syntaxe

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

Unités

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

Note : Bien que le nombre 0 soit toujours identique quelle que soit l'unité, l'unité ne doit jamais être omise. Autrement dit, 0 est invalide et ne représente pas 0Hz ou 0kHz. Même si les unités ne sont pas sensibles à la casse, il est recommandé d'utiliser un « H » majuscule pour Hz et kHz, comme spécifié dans le Système international d'unités.

Exemples

Valeurs de fréquence valides :

12Hz     Entier positif
4.3Hz    Nombre non entier
14KhZ    L'unité n'est pas sensible à la casse, mais il est déconseillé d'utiliser une majuscule non conforme au SI.
+0Hz     Zéro, avec un signe + et une unité
-0kHz    Zéro, avec un signe - et une unité

Valeurs de fréquence invalides :

12.0     Ceci est un <number>, pas une <frequency>, car il manque une unité.
7 Hz     Il ne doit pas y avoir d'espace entre le nombre et l'unité.
0        Bien que le zéro sans unité soit autorisé pour <length>, il est invalide pour <frequency>.

Spécifications

Specification
CSS Values and Units Module Level 4
# frequency-value

Compatibilité des navigateurs

Actuellement, aucun navigateur ne prend en charge cette fonctionnalité.

Voir aussi