CSS Reference

color-scheme

要素がどのカラーモードをサポートするかを指定する

color-scheme プロパティは、要素がどのカラーモード（ライドモードやダークモードなど）をサポートするかを指定します。

prefers-color-scheme メディア特性を使用することでユーザーが使用しているカラーモードに応じたスタイルを出し分けることができますが、color-scheme プロパティを使用することで、各要素がどのカラーモードをサポートしているのかを示すことができます。

指定可能な値は下記の通りです。

normal ユーザエージェント側で設定されたカラースキームをサポートすることを示します（設定がない場合は、特にカラースキームをサポートしません）。
light 要素がライトモードに適したカラースキームをサポートすることを示します。
dark 要素がダークモードに適したカラースキームをサポートすることを示します。
only 要素のカラースキームをユーザエージェントが上書きすることを禁止します。

例えば、ルート要素に color-scheme プロパティを下記のように指定することで、文書内の全要素に対して、ライドモードとダークモードの両方をサポートしていると示すことができます。

:root {
  color-scheme: light dark;
}

また、何らかの理由で、ユーザーがダークモードを設定していたとしてもライトモードでの表示のみ許可したい場合は、下記のように指定することもできます。

:root {
  color-scheme: only light;
}

color-schemeの仕様

初期値
  • normal
対象となる要素
  • すべての要素
継承
  • あり

color-schemeのサンプルソース

:root {
  color-scheme: light dark;
}

@media (prefers-color-scheme: light) {
  .sample {
    color: black;
    background-color: white;
  }
}

@media (prefers-color-scheme: dark) {
  .sample {
    color: white;
    background-color: black;
  }
}

主要ブラウザの対応

IE11 ×
Edge（EdgeHTML） ×
Edge（Chromium） ○
Chrome ○
Firefox ○
Safari ○
iOS Safari ○
Android Chrome ○

関連するプロパティ

仕様書

用途から CSS プロパティやセレクタを探す

用途から CSS プロパティやセレクタを逆引きできます。

対応ブラウザから CSS プロパティやセレクタを探す

対応ブラウザから CSS プロパティやセレクタを逆引きできます。

Edge（EdgeHTML）
Edge（Chromium）
Firefox
Chrome
Safari
iOS Safari
Android Chrome