Web標準によるダークモード
Dark Mode with Web Standards (olliewilliams.xyz)
要約
この記事は、Web標準技術を用いてウェブサイトにダークモードを実装する方法について解説しています。ユーザーのOS設定を尊重する`prefers-color-scheme`メディアクエリと、サイト固有の設定を可能にする`color-scheme`メタタグやJavaScriptの使用法を説明しています。また、画像やグラデーションでの`light-dark()`関数の活用や、将来的な高度なスタイル変更の可能性についても触れています。
全文翻訳
Web標準によるダークモードの実装
2026年6月12日
ユーザーのOS設定を尊重することは簡単です。CSSでprefers-color-schemeメディアクエリを使用します。しかし、これだけでは不十分かもしれません。ユーザーはサイトごとに設定をカスタマイズできるべきです。例えば、アプリケーションのUIにはダークモードを、コンテンツが多いサイトの長文を読む際にはライトモードを希望するユーザーもいるでしょう。
以下の対応が必要です。
- ユーザーが初めてウェブサイトにアクセスした際のデフォルトとして、ユーザーのシステム設定をサポートする。
- アプリケーション内のトグルで、ユーザーがシステム設定を上書きできるようにする。
ウェブページのカラースキームは、ドキュメントの<head>内のHTMLメタタグ、またはhtml要素のCSS color-schemeプロパティで設定できます。低速な接続ではCSSの読み込みに時間がかかる場合があるため、メタタグの使用が推奨されます。ユーザーが初めてウェブサイトにアクセスした際に、<meta name="color-scheme" content="light dark">を設定してシステム設定を尊重してください。ウェブアプリやサイト内のコントロールを通じてOS設定を上書きするには、JavaScriptを使用してcontent属性の値をlight(ライトモードを強制)、dark(ダークモードを強制)、またはlight dark(OS設定に戻す)に更新します。
const metaTag = document.querySelector('[name="color-scheme"]');
const savedScheme = localStorage.getItem("colorScheme");
if (savedScheme) {metaTag.setAttribute('content', savedScheme);}
btnlight.addEventListener('click', function() {
metaTag.setAttribute('content', 'light');
localStorage.setItem("colorScheme", "light");
});
btndark.addEventListener('click', function() {
metaTag.setAttribute('content', 'dark');
localStorage.setItem("colorScheme", "dark");
});
btnsystem.addEventListener('click', function() {
metaTag.setAttribute('content', 'light dark');
localStorage.removeItem("colorScheme");
});
color-schemeは何に影響しますか?
light-dark()CSS関数で設定された色、グラデーション、または画像CanvasやCanvasTextのようなシステムカラー- スクロールバーの色
- ボタンのようなHTML要素のデフォルトの色
- iframeのスタイル(iframeドキュメントがメタタグを通じてオプトインしている場合)
light-dark()またはprefers-color-schemeを使用するSVG
color-schemeは何に影響しませんか?
color-schemeとprefers-color-schemeメディアクエリの間には、残念ながら断絶があります。prefers-color-schemeは、color-schemeの値に関わらず、OSの設定を反映します。ページ内トグルを提供してダークモードを実装する場合、prefers-color-schemeメディアクエリを採用することはできません。
以下のコードはcolor-schemeの影響を受けません。
<picture>
<source srcset="logo-dark.png" media="(prefers-color-scheme: dark)" />
<img src="logo-light.png" alt="Product logo" />
</picture>
background-imageを使用する場合を除き、<picture>要素に相当するアプローチでcolor-schemeを参照できるものは残念ながらありません。
color-schemeがprefers-color-schemeメディアクエリに影響を与える例外は2つあります。
- iframe
- SVG
以下は、同じドキュメントを示す2つのiframeです。iframe内のドキュメントはprefers-color-schemeメディアクエリを使用しています。
<iframe style="color-scheme: light;" src="/example.html"></iframe>
<iframe style="color-scheme: dark;" src="/example.html"></iframe>
上記の例からわかるように、color-scheme: darkが親ドキュメントで使用されている場合、@media (prefers-color-scheme: dark)のスタイルが適用されています。
この原則はSVGにも当てはまります。以下は.svgファイルの内容です。
<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
<style>
circle {
fill: rgb(40,40,40);
}
@media (prefers-color-scheme: dark) {
circle {
fill: rgb(216, 216, 216);
}
}
</style>
<circle cx="50" cy="50" r="50" />
</svg>
<img style="color-scheme: light;" src="/circle.svg" alt="">
<img style="color-scheme: dark;" src="/circle.svg" alt="">
[画像: ダークモードとライトモードで異なる色になるSVGの例] [画像: ダークモードとライトモードで異なる色になるSVGの例]
CSS仕様は最近更新され、ドキュメントのcolor-schemeがメディアクエリに影響を与えるようになりましたが、どのブラウザもまだ実装していません。これを優先させるには、関連するChromium issueで+1をクリックしてください。
Safariの注意点
- SVG内での
prefers-color-schemeメディアクエリのサポートはSafari 27で追加されましたが、color-schemeはメディアクエリに影響しません(バグレポート参照)。 - iframe内での
prefers-color-schemeメディアクエリのサポートはSafari 27で追加され、親ドキュメントのcolor-schemeはそれをオーバーライドします。これは期待通りです🎉。しかし、他のバグも残っています(バグレポート参照)。
画像とグラデーションでのlight-dark()の使用
light-dark()関数は当初色に限定されていました。Chrome/Edgeバージョン150、Firefoxバージョン150、Safari Technology Preview以降では、グラデーションや画像にも使用できるようになりました。
.bg-gradient {
background-image: light-dark(linear-gradient(15deg, #b9b6ff, #308dc6), linear-gradient(15deg, #6b7495, #001339));
}
<div class="bg-gradient" style="color-scheme: light;"></div>
<div class="bg-gradient" style="color-scheme: dark;"></div>
color-schemeに応じて、単色の背景とグラデーションを切り替えることも可能です。
.bg-grad-solid {
background-image: light-dark(linear-gradient(15deg, #b9b6ff, #308dc6), image(#001339));
}
画像
.bg {
background-image: light-dark(url(/lightmode.avif), url(/darkmode.avif));
}
色、画像、グラデーション以上の変更
概して、モード間で変更する必要があるのは色ですが、例外もあります。例えば、box-shadowはダークモードの暗い背景では見えにくいため、代わりに境界線(border)を適用することを決定するかもしれません。これを実装するのは現在かなり困難です。CSS標準化団体は、CSS if()文またはスタイルクエリを使用して現在のカラースキームを検出する方法を追加する予定ですが、どのブラウザもこの機能は実装していません。代替手段をハックすることは可能です。ここでは2つのアプローチを見ていきます。
ページがダークモードを使用している場合にtrueとなるCSS変数(CSS variable)を定義します。
html {
--dark: false;
}
html:has([content="light dark"]) {
@media (prefers-color-scheme: dark) {
--dark: true;
}
}
html:has([content="dark"]) {
--dark: true;
}
すべてのブラウザは現在、カスタムプロパティの値に応じてスタイルを適用できるスタイルクエリをサポートしています。
@container style(--dark: false) {
.card {
box-shadow: 0px 2px 3px rgba(0, 0, 0, 0.2);
}
}
@container style(--dark: true) {
.card {
border: solid 1px rgb(94, 94, 94);
}
}
スタイルクエリを使用する、より良いアプローチは次のようになります。
@property --usedScheme {
syntax: "<color>";
inherits: true;
initial-value: transparent;
}
body {
--usedScheme: light-dark(white, black);
}
@container style(--usedScheme: white) {
.card {
box-shadow: 0px 2px 3px rgba(0, 0, 0, 0.2);
}
}
@container style(--usedScheme: black) {
.card {
border: solid 1px rgb(94, 94, 94);
}
}
(可能性のある)未来:JavaScriptによるprefers-color-schemeのオーバーライド
将来的には、JavaScriptでprefers-color-schemeメディアクエリをオーバーライドする方法が得られるかもしれません。仕様やMDNのエントリがあり、Chrome Canaryではプロトタイプが存在しますが、Safariチームはこのアイデアに反対しています(WebKit/standards-positions issue)。