Light-dark() - Fonction CSS

light-dark()

Résumé des caractéristiques de la fonction light-dark()

Description rapide
Permet de choisir entre deux couleurs pour adapter l'apparence d'un élément à la palette utilisée (claire ou foncée).
Statut
Standard
Pourcentages
Ne s'appliquent pas.
Type d'animation
Discrète : lors d'une animation, la propriété light-dark() passe d'une valeur à l'autre sans transition.
Module W3C
Module CSS - Ajustement des couleurs
Références (W3C)
Statut du document: CR (document candidat à la recommandation)

Schéma syntaxique de light-dark()..

light-dark - Syntax DiagramSyntax diagram of the light-dark CSS function. c1 c1 c2 c2light-dark()light-dark()
Schéma syntaxique de la fonction light-dark().
Description des valeurs.

Description des termes utilisés sur le schéma :

  • c1 et c2 sont deux couleurs, exprimées dans une des syntaxes reconnues par CSS (voir Les couleurs.

Description de la fonction light-dark().

light-dark() permet de choisir entre deux couleurs, une pour le mode d'affichage clair, l'autre pour le mode d'affichage foncé. La basculement d'une couleur à l'autre est automatique en fonction du mode d'affichage actuel.

light-dark() est surtout utile pour les éléments qui ne sont pas des contrôles de formulaire, ni des barres de défilement car ces élément sont automatiquement basculé d'une couleur à l'autre en fonction de la palette utilisée.

La valeur light-dark() peut être utilisée avec les propriétés suivantes :

  • accent-color : Définit la couleur des élément actifs, cochés.
  • background-color : Définit la couleur en arrière-plan.
  • border-color : Définit la couleur des bordures.
  • caret-color : Choisit la couleur du marqueur de texte (curseur clignotant).
  • color : Définit la couleur de l'avant plan (texte essentiellement).
  • column-rule-color : Définit la couleur des lignes de séparation de colonnes.
  • fill-color : Définit la couleur des remplissages en SVG.
  • flood-color : Définit la couleur des remplissages et des ombrages dans le contexte de filtres SVG.
  • lighting-color : Définit la couleur de l'éclairage dans le contexte d'un filtre SVG.
  • outline-color : Définit la couleur du contour (outline).
  • scrollbar-color : Définit deux couleurs qui seront utilisées pour les barres de défilement.
  • stop-color :
  • text-decoration-color : Définit la couleur du trait de décoration (souligné, rayure...).
  • text-emphasis-color : Définit la couleur des caractères de mise en exergue.

Syntaxes de la fonction light-dark().

  • [propriété]: light-dark(yellow, blue); c1 c2

    c1 est la couleur pour le mode clair ou tout autre mode qui n'est pas dark. c2 est la couleur pour le mode foncé (dark).

Exemples d'utilisation de la fonction light-dark().

Cette page a été adaptée (en partie) pour un basculement d'une palette claire à une palette foncée. Les titres h1, h2 et h3, les bandeaux de syntaxe, et la table des matières ont des couleurs qui s'adaptent à la palette.

Support de la fonction light-dark().

Colonne 1
Support de la fonction light-dark() permettant de choisir entre deux couleurs en fonction de la palette de couleurs (sombre ou claire).
1
Fonction
light-dark()
Estimation de la prise en charge globale.
87%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

UC Browser pour Androïd

Opéra Mobile

QQ Browser

Baidu Browser

Samsung Internet

Safari

Opéra

Safari sur IOS

Firefox pour Androïd

Chrome

Firefox

Edge

Chrome pour Androïd

Androïd Brower

KaiOS Browser

Opéra mini

Historique de la fonction light-dark().

Voir aussi, au sujet de l'ajustement des couleurs...

Les spécifications CSS éditées par le W3C sont organisées en modules. La fonction light-dark() fait partie du module CSS Color Adjustment Module, ainsi que les autres fonctions et propriétés ci-après.

Propriétés :

color-adjust
Autorise ou non le navigateur à optimiser les couleurs.
color-scheme
Définit si un élément doit s'afficher en mode nuit (dark) ou en mode jour (light). Ces deux modes sont en principe gérés par tous les systèmes d'exploitation.
forced-color-adjust
Définit comment sont ajustées les couleurs.
print-color-adjust
Indique si le navigateur doit optimiser les couleurs lors de l'impression du document.