Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

color-scheme — esquemas de cores suportados

color-scheme declara o suporte à apresentação clara ou escura e influencia os controlos nativos e as cores do sistema.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

color-scheme: normal | [ light | dark | <custom-ident> ]+ && only?;

A propriedade color-scheme é herdada. O valor inicial normal não declara suporte para nenhum esquema de cores. O esquema predefinido do navegador é a opção de recurso: sem only, o navegador pode usar outro esquema para respeitar uma preferência do utilizador que tenha prioridade. Um elemento descendente com normal definido explicitamente pode ter um aspeto diferente do elemento raiz da página se este utilizar dark.

light dark suporta ambos os esquemas e tem em conta a preferência do utilizador. Se não houver uma preferência definida, é utilizado o primeiro esquema suportado. only light impede que o navegador substitua o esquema, mas não desativa o modo de cores forçadas.

A propriedade não substitui a sua paleta nem as consultas prefers-color-scheme. As cores do sistema Canvas e CanvasText formam um par correspondente de fundo e texto. Os seus valores concretos dependem do ambiente.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>color-scheme</title>
<style>
  :root { color-scheme: light dark; }
  body { background: Canvas; color: CanvasText; }
  section { padding: 1rem; margin: 1rem 0; background: Canvas; color: CanvasText; }
  .light { color-scheme: only light; }
  .dark { color-scheme: only dark; }
</style>
<section class="light">
  <label>Light <input value="Sample"></label>
</section>
<section class="dark">
  <label>Dark <input value="Sample"></label>
</section>
</html>

Resultado

With light and dark schemes supported and forced colors disabled, Light uses a light scheme and Dark uses a dark scheme under either user preference. Exact colors and native input styling vary.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes