forced-color-adjust

La propriété CSS forced-color-adjust permet aux auteurs de ne pas activer les modes de couleurs forcées sur certains éléments. Cela restaure la possibilité de contrôler ces valeurs en CSS.

Syntaxe

css
forced-color-adjust: auto;
forced-color-adjust: none;

/* Valeurs globales */
forced-color-adjust: inherit;
forced-color-adjust: initial;
forced-color-adjust: revert;
forced-color-adjust: unset;

La valeur de la propriété forced-color-adjust doit être l'un des mots-clés suivants.

Valeurs

auto

En mode de couleurs forcées, les couleurs de l'élément sont définies par l'agent utilisateur. C'est la valeur par défaut.

none

Même en mode de couleurs forcées, les couleurs de l'élément ne sont pas automatiquement définies par l'agent utilisateur.

Notes d'utilisation

Cette propriété ne devrait être utilisée que pour faire des modifications qui prendront en charge les pré-requis de couleurs et de contrastes. Par exemple, si vous savez que les optimisations de couleur faites par l'agent utilisateur conduisent à une mauvaise expérience en mode contrasté ou en mode sombre. L'utilisation de cette propriété vous permettra alors de modifier le résultat dans ce mode pour proposer une meilleure expérience. Elle ne devrait pas être utilisée dans le but d'empêcher les choix de l'utilisateur d'être respectés.

Cette propriété est une version standard de la propriété -ms-high-contrast-adjust (en anglais). La propriété préfixée peut être utilisée pour obtenir un résultat similaire sur Internet Explorer 10 et sur les versions EdgeHTML de Microsoft Edge.

Définition formelle

Valeur initialeauto
Applicabilitéall elements and text
Héritéeoui
Valeur calculéecomme spécifié
Type d'animationNot animatable

Syntaxe formelle

forced-color-adjust = 
auto |
none |
preserve-parent-color

Exemples

Préserver les couleurs

Dans l'exemple ci-dessous, la première boîte utilise le jeu de couleur définit par l'utilisateur. Par exemple, dans le mode à forts contrastes sombre de Windows, cela donnera du texte blanc sur fond noir. La seconde boîte conservera quant à elle les couleurs du site définies par la classe .box.

En utilisant la fonctionnalité média forced-colors, vous pouvez ajouter n'importe qu'elle autre optimisation pour le mode de couleurs forcées aux côtés de la propriété forced-color-adjust.

CSS

css
.box {
  border: 5px solid grey;
  background-color: #ccc;
  width: 300px;
  margin: 20px;
  padding: 10px;
}

@media (forced-colors: active) {
  .forced {
    forced-color-adjust: none;
  }
}

HTML

html
<div class="box">
  <p>Voici une boîte qui utilisera vos préférences de couleurs.</p>
</div>

<div class="box forced">
  <p>Voici une boîte qui conservera les couleurs définies par le site.</p>
</div>

Résultat

L'exemple présenté ci-dessus affiche la première boîte avec un arrière-plan noir et la seconde avec un arrière-plan gris définit en CSS.

Spécifications

Specification
CSS Color Adjustment Module Level 1
# forced-color-adjust-prop

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi