このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

<meta name="color-scheme"> 属性値

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年1月以降、すべてのブラウザーで利用可能です。

color-scheme は <meta> 要素の name 属性の値で、ユーザーエージェントにページで使用するよう推奨する配色を示します。 指定する場合、配色は <meta> 要素の content 属性に、有効な CSS color-scheme 値で定義します。

文書の配色は文書レベルで適用されます。一方、CSS の color-scheme プロパティは、個々の要素で優先する配色と受け入れ可能な配色を指定します。 <meta name="color-scheme"> の主な用途は、ライトモードとダークモードの互換性と優先順位を示すことです。 例えば、文書がダークモードを推奨するが、ライトモードにも対応していることを示すには、次のように記述します。

html
<meta name="color-scheme" content="dark light" />

CSS の prefers-color-scheme メディア特性を使用すると、スタイルを現在の配色に合わせることができます。

使用上のメモ

<meta name="color-scheme"> 要素には、次の属性があります。

content

<meta> 要素で name="color-scheme" を指定する場合、配色を CSS の color-scheme 値として定義する content 属性が必要です。 content 属性は、次のいずれかになります。

normal

この文書は配色を認識しないため、デフォルトのカラーパレットを使って描画します。

light, dark, light dark, dark light

この文書で対応している 1 つ以上の配色。 複数の配色を指定すると、文書では最初の配色が推奨されますが、ユーザーが 2 つ目の配色を希望した場合は、2 つ目の配色も受け入れられます。 同じ配色を複数回指定しても、1 回指定した場合と同じ効果になります。

only light

この文書がライトモードのみに対応していることを示します。背景色が明るく、前景色が暗い色です。 only dark は無効です。ダークモードに対応していない文書を強制的にダークモードで描画すると、コンテンツが読めなくなる可能性があるためです。特に設定されていない場合、主要なブラウザーはデフォルトでライトモードになります。

例

color-scheme キーワードの使用

次の例は、ページがライトテーマとダークテーマの両方に対応していることをブラウザーに指示しています。 ライトまたはダークの配色が使用されるかどうかは、OS レベルの設定やブラウザーの設定などのユーザーの環境設定によって決まります。

html
<meta name="color-scheme" content="light dark" />

仕様書

仕様書
HTML
# meta-color-scheme

ブラウザーの互換性

関連情報