`prefers-contrast` CSS media feature

The prefers-contrast CSS media feature is used to detect whether the user has requested the web content to be presented with a lower or higher contrast.

Syntax

• no-preference
  • : Indicates that the user has made no preference known to the system. This keyword value evaluates as false in the Boolean context.
• more
  • : Indicates that user has notified the system that they prefer an interface that has a higher level of contrast.
• less
  • : Indicates that user has notified the system that they prefer an interface that has a lower level of contrast.
• custom
  • : Indicates that user has notified the system for using a specific set of colors, and the contrast implied by these colors matches neither more nor less. This value will match the color palette specified by users of forced-colors: active.

User preferences

Various operating systems do support such preferences and user agents are likely to rely on the settings provided by the operating system.

Examples

This example includes a box with a dashed outline set on it by default. When the prefers-contrast: more media query matches, the applied outline is given a higher contrast solid style instead.

HTML

<div class="contrast">low contrast box</div>

CSS

.contrast {
  margin: 5px;
  width: 100px;
  height: 100px;
  outline: 2px dashed black;
}

@media (prefers-contrast: more) {
  .contrast {
    outline: 2px solid black;
  }
}

Result

Specifications

Browser compatibility

See also

• CSS forced-colors media query