Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

prefers-color-scheme

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨janeiro de 2020⁩.

* Some parts of this feature may have varying levels of support.

Nota: Se você definiu privacy.resistFingerprinting como true, prefers-color-scheme será substituída pela light.

O prefers-color-scheme CSS media feature é usado para detectar se o usuário solicitou que o sistema use um tema de cores claras ou escuras.

Syntax

no-preference

Indica que o usuário não fez nenhuma preferência conhecida pelo sistema. Este valor da palavra-chave é avaliado como false no contexo booleano.

light

Indica que o usuário notificou o sistema de que prefere uma interface com um tema claro.

dark

Indica que o usuário notificou o sistema de que prefere uma interface com um tema escuro.

Exemplos

Os elementos abaixo têm um tema de cores inicial. Eles podem ser mais temáticos de acordo com a preferência do esquema de cores do usuário.

HTML

html
<div class="day">Dia (inicial)</div>
<div class="day light-scheme">Dia (modificar e utilizar um tema claro)</div>
<div class="day dark-scheme">Dia (modificar e utilizar um tema escuro)</div>
<br />

<div class="night">Noite (inicial)</div>
<div class="night light-scheme">Noite (modificar e utilizar um tema claro)</div>
<div class="night dark-scheme">Noite (modificar e utilizar um tema escuro)</div>

CSS

css
.day {
  background: #eee;
  color: black;
}
.night {
  background: #333;
  color: white;
}

@media (prefers-color-scheme: dark) {
  .day.dark-scheme {
    background: #333;
    color: white;
  }
  .night.dark-scheme {
    background: black;
    color: #ddd;
  }
}

@media (prefers-color-scheme: light) {
  .day.light-scheme {
    background: white;
    color: #555;
  }
  .night.light-scheme {
    background: #eee;
    color: black;
  }
}

.day,
.night {
  display: inline-block;
  padding: 1em;
  width: 7em;
  height: 2em;
  vertical-align: middle;
}

Resultado

Especificações

Specification
Media Queries Level 5
# prefers-color-scheme

Compatibilidade com navegadores

Veja também

  1. -moz-device-pixel-ratio Não padrão Deprecated
  2. -webkit-animation Não padrão Deprecated
  3. -webkit-device-pixel-ratio
  4. -webkit-transform-2d Não padrão
  5. -webkit-transform-3d
  6. -webkit-transition Não padrão Deprecated
  7. any-hover
  8. any-pointer
  9. aspect-ratio
  10. color
  11. color-gamut
  12. color-index
  13. device-aspect-ratio Deprecated
  14. device-height Deprecated
  15. device-posture Experimental
  16. device-width Deprecated
  17. Modo de exibição (display-mode)
  18. dynamic-range
  19. forced-colors
  20. grid
  21. height
  22. horizontal-viewport-segments Experimental
  23. hover
  24. inverted-colors
  25. monochrome
  26. orientation
  27. overflow-block
  28. overflow-inline
  29. pointer
  30. prefers-color-scheme
  31. prefers-contrast
  32. prefers-reduced-data Experimental
  33. prefers-reduced-motion
  34. prefers-reduced-transparency Experimental
  35. resolution
  36. scan
  37. scripting
  38. shape Experimental
  39. update
  40. vertical-viewport-segments Experimental
  41. video-dynamic-range
  42. width