ライトモードとダークモードで文字色や背景色を切り替えたいとき、CSSのlight-dark()を使うと『明るい配色用の値・暗い配色用の値』を1つの宣言にまとめられます。基本は:rootにcolor-scheme: light darkを指定し、backgroundやcolorへlight-dark(明るい値, 暗い値)を設定します。prefers-color-schemeのメディアクエリが不要になる場面もありますが、古いブラウザー向けには通常の色を先に書いてフォールバックを残しておくと安全です。
light-dark()とは?
light-dark()は、要素で使われているカラースキームがlightなら1つ目の値、darkなら2つ目の値を選ぶCSS関数です。色を切り替える用途ではlight-dark(ライト用の色, ダーク用の色)の順で書きます。
用語解説:color-scheme
ページや要素がライト系・ダーク系のどの配色に対応するかをブラウザーへ伝えるCSSプロパティです。フォーム部品などブラウザー側のUI表現にも関係します。
:root {
color-scheme: light dark;
}
body {
background: light-dark(#ffffff, #111827);
color: light-dark(#1f2937, #f9fafb);
}
最小のライト・ダーク切り替えを作る
最初は背景色と文字色だけを切り替えると仕組みを理解しやすくなります。color-scheme: light darkを指定したうえで、同じ要素の色をlight-dark()へまとめます。
<main class="card">
<h2>学習メモ</h2>
<p>CSSの配色を切り替えてみよう。</p>
</main>
:root {
color-scheme: light dark;
}
.card {
background-color: light-dark(#f8fafc, #1e293b);
color: light-dark(#0f172a, #f8fafc);
border: 1px solid light-dark(#cbd5e1, #475569);
padding: 1.5rem;
border-radius: 0.75rem;
}
ブラウザー・OS側で選ばれたスキームに応じて、cardの背景・文字・境界線が同じルール内で切り替わります。
prefers-color-schemeとの違い
| 方法 | 書き方 | 向いている場面 |
|---|---|---|
| light-dark() | 1つのCSS値の中にlight/darkの2値を書く | 同じプロパティの値だけを切り替えたい |
| @media (prefers-color-scheme) | dark用のルール群を別ブロックで書く | レイアウトや複数プロパティをまとめて大きく変更したい |
light-dark()はメディアクエリの完全な置き換えではありません。色の値をペアで管理したい場合は簡潔ですが、ダークモード時だけ影を消す、画像を差し替える、レイアウトを変えるなど複数のルールをまとめるならメディアクエリのほうが読みやすい場合があります。
CSS変数と組み合わせる
色を何度も直接書くより、カスタムプロパティへまとめると配色の役割が分かりやすくなります。初心者のうちは『背景』『文字』『強調色』のように用途で名前を付けると管理しやすくなります。
:root {
color-scheme: light dark;
--color-bg: light-dark(#ffffff, #0f172a);
--color-surface: light-dark(#f8fafc, #1e293b);
--color-text: light-dark(#111827, #f8fafc);
--color-accent: light-dark(#2563eb, #60a5fa);
}
body {
background: var(--color-bg);
color: var(--color-text);
}
a {
color: var(--color-accent);
}
あとから配色を変更するときは変数の定義を中心に見直せるため、同じ色の指定が画面中へ散らばりにくくなります。
古いブラウザー向けのフォールバック
MDNでは色としてのlight-dark()をBaseline 2024として案内していますが、古いブラウザーや端末では利用できない可能性があります。対応していない環境でも文字が読めるよう、通常の色を先に指定してからlight-dark()を上書きする方法があります。
:root {
color-scheme: light dark;
}
body {
background: #ffffff;
color: #1f2937;
background: light-dark(#ffffff, #111827);
color: light-dark(#1f2937, #f9fafb);
}
light-dark()を解釈できないブラウザーでは、その宣言が採用されず、先に書いた通常の色が残る構成を狙えます。実際の対象ブラウザーで確認してください。
見た目だけでなくコントラストも確認する
ライト用とダーク用に2色を用意しても、文字と背景の組み合わせが読みにくければ良い配色とは言えません。特にリンク、ボタン、補助テキストは両方のスキームで確認します。
- ライトモードで文字と背景のコントラストを確認する。
- ダークモードでも同じ要素を確認する。
- リンクが通常テキストと区別できるか確認する。
- hoverやfocus時の色も両スキームで見落とさない。
- 色だけで状態やエラーを伝えない。
CSS Color Level 5の仕様例でも、light-dark()を使ってライト・ダークそれぞれで読みやすいリンク色を選ぶ例が示されています。
切り替わらないときの確認ポイント
- :rootや対象要素でcolor-scheme: light darkを指定しているか。
- OSやブラウザーのカラースキーム設定が想定どおりか。
- 後ろのCSSでbackgroundやcolorが上書きされていないか。
- ブラウザーがlight-dark()へ対応しているか。
- CSS変数を使っている場合は、変数名のスペルと適用範囲を確認する。
まず1要素だけに直接light-dark()を書いて挙動を確認し、動いたらCSS変数へ整理すると、原因を切り分けやすくなります。
よくある質問とまとめ
light-dark()だけ書けば自動でダークモードになりますか?
値の選択は要素のカラースキームに基づきます。基本例ではcolor-scheme: light darkも合わせて指定します。
prefers-color-schemeはもう不要ですか?
不要になる場面はありますが、ダーク時だけ複数のルールや構造的な変更をまとめたい場合はメディアクエリが適することもあります。
CSS変数の中でも使えますか?
使えます。背景・文字・強調色などの役割ごとにカスタムプロパティへまとめると管理しやすくなります。
light-dark()は、ライト・ダークで変わる色を1か所にまとめるための選択肢です。まず背景と文字の2色から試し、両モードのコントラストを確認してから配色変数へ広げてみてください。