hwb()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2022.

La notation fonctionnelle hwb() exprime une couleur donnée selon sa teinte, sa blancheur et sa noirceur. Une composante alpha optionnelle représente l'opacité de la couleur.

Exemple interactif

Syntaxe

css
hwb(194 0% 0%) /* #00c3ff */
hwb(194 0% 0% / .5) /* #00c3ff avec 50% d'opacité */

Valeurs

Note : La fonction hwb() n'utilise pas de virgule pour séparer les valeurs des arguments, et la valeur alpha optionnelle doit être précédée d'une barre oblique (/) si elle est fournie.

hwb(H W B[ / A])

H (teinte, hue en anglais) est un angle (type <angle>) sur le cercle des couleurs. Lorsqu'il est écrit sans unité, il est interprété comme étant exprimé en degré. Par définition, on a red=0deg=360deg, et les autres couleurs distribuées sur le cercle avec green=120deg, blue=240deg, etc. Sa valeur étant un <angle>, elle boucle sur elle-même et on a donc -120deg=240deg, 480deg=120deg, -1turn=1turn, etc.

W (blancheur, whiteness en anglais) indique la quantité de blanc dans la couleur, indiquée comme un pourcentage (type <percentage>), où 0% indique aucune blancheur et où 100% indique une blancheur complète.

B (noirceur, blackness) indique la quantité de noir dans la couleur, indiquée comme un pourcentage (type <percentage>), où 0% indique aucune noirceur et où 100% indique une noirceur complète.

A (alpha) peut être un nombre (type <number>) compris entre 0 et 1, ou un pourcentage (type <percentage>), où 1 correspond à 100% (opacité complète).

Spécifications

Specification
CSS Color Module Level 5
# relative-HWB
CSS Color Module Level 4
# the-hwb-notation

Compatibilité des navigateurs

BCD tables only load in the browser