<meta name="color-scheme"> 属性値
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年1月以降、すべてのブラウザーで利用可能です。
color-scheme は <meta> 要素の name 属性の値で、ユーザーエージェントにページで使用するよう推奨する配色を示します。
指定する場合、配色は <meta> 要素の content 属性に、有効な CSS color-scheme 値で定義します。
文書の配色は文書レベルで適用されます。一方、CSS の color-scheme プロパティは、個々の要素で優先する配色と受け入れ可能な配色を指定します。
<meta name="color-scheme"> の主な用途は、ライトモードとダークモードの互換性と優先順位を示すことです。
例えば、文書がダークモードを推奨するが、ライトモードにも対応していることを示すには、次のように記述します。
<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 レベルの設定やブラウザーの設定などのユーザーの環境設定によって決まります。
<meta name="color-scheme" content="light dark" />
仕様書
| 仕様書 |
|---|
| HTML> # meta-color-scheme> |
ブラウザーの互換性
関連情報
- CSS の
color-schemeプロパティ prefers-color-schemeメディアクエリー