light-dark()は何を優先したのか:色を決める責務をブラウザへ返すという価値選択

著者: ClaudeMix Team |

CSSの light-dark() 関数は、色を決める責務をJavaScriptからブラウザとCSSへ返すことを優先している。

① light-dark()は何を優先したか

ダークモード対応の一般的な実装は、useEffect で localStorage を読み、document.documentElement へ属性を付与し、CSSがその属性を見て色を切り替える。この構造は、HTML到達からJS実行・Hydration完了までの間、テーマが確定しないという特性を持つ。

light-dark() はCSS Color Level 5の関数で、color-scheme プロパティと組み合わせることで、ブラウザが prefers-color-scheme を直接解決する。CSSが解析された時点で色が確定し、JSの実行を待たない。

  • 【優先した価値】: レンダリングの透明性とWeb標準への準拠。ブラウザがOSからすでに受け取っている prefers-color-scheme を、JSが二重に処理することをやめる
  • 【犠牲にした価値】: Reactによる状態の一元管理。テーマの「表示」はCSSとサーバーが持つことになり、実装が単一ファイルから複数層へ分散する

② ClaudeMixでやったこと

Before: ThemeToggleButton.tsx が useEffect で localStorage を読み、document.documentElement に data-theme 属性を付与していた。globals.css は html[data-theme="dark"] セレクタで色を上書きしていた。

/* globals.css(変更前) */
:root { --color-background-primary: #ffffff; }
html[data-theme="dark"] { --color-background-primary: #0c101b; }

After: data-theme セレクタを全て削除し、色変数を light-dark() へ書き換えた。ユーザーの明示的な選択はCookieに保存し、root.tsx の loader で読み取って html 要素の style へ直接注入する。

/* globals.css(変更後) */
:root {
  color-scheme: light dark;
  --color-background-primary: light-dark(#ffffff, #0c101b);
  --color-text-primary: light-dark(#111827, #e6edf3);
}
// root.tsx(変更後)
export async function loader({ request }: LoaderFunctionArgs) {
  const colorScheme = getColorSchemeFromCookie(request.headers.get('Cookie'));
  return { colorScheme };
}

export default function App() {
  const { colorScheme } = useLoaderData<typeof loader>();
  return <html lang="ja" style={colorScheme ? { colorScheme } : undefined}>...</html>;
}

ThemeToggleButton.tsx の責務は「state更新」「style.colorScheme への書き込み」「Cookieへの非同期POST」の3つに縮小した。localStorage の読み書きはゼロになった。

③ 技術的負債

  • 【解消した負債】: テーマ確定がCSS解析時点(HTMLパース時)に前倒しされ、useEffect の実行を待つ待機がなくなった。FOUCは構造として発生しなくなったが、この改善量を示すSI/LCPの定量計測(PageSpeed Insights)は実施していない
  • 【新たに生まれた負債(あれば)】: 実装箇所が useEffect 一本から、globals.css・Cookie発行処理・root.tsx の loader・ThemeToggleButton.tsx の4箇所へ分散した。変更の影響範囲を追うコストが増加した

④ 経営翻訳

来客の温度調整の希望を、受付係が毎回聞き取ってから空調を調整していた運用を、建物の空調システム自体が来客の事前申告(会員証への記録)を直接読み取って調整する仕組みへ切り替えた。受付係を経由する遅れはなくなったが、空調の設定情報が「会員証」「建物の受付ログ」「空調システムの初期設定」の複数箇所に分かれることになった。

この設計判断による体感速度の改善は、社内の来客満足度調査のような定量的な計測ではまだ裏付けを取っていない。ブラウザという「建物」の仕様上、理屈のうえでは遅れが構造的に発生しなくなったという説明に留まる。