OKLCH Colors
OKLCHは、明度(Lightness)、クロマ(Chroma)、色相(Hue)が有用なデザインパラメータとなる知覚的に均一な色空間です。プロジェクトが既にOKLCHを使用している場合、新しいカラーシステムを作成する場合、またはユーザーが変換やパレット作業を依頼した場合に使用してください。それ以外の場合は、プロジェクトの確立されたトークンと表記法を維持してください。一貫性のあるhexまたはRGBトークンシステムは、孤立した修正のために別の色表現を導入するよりも優れています。インタラクティブに試すには、oklch.fyi にアクセスしてください。
クイックリファレンス
| カテゴリ | 使用タイミング | リファレンス |
|---|---|---|
| 変換 | Hex/rgb/hsl から oklch へ | color-conversion.md |
| パレット | スケール、マルチ色相、ダークモードの生成 | palette-generation.md |
| コントラスト | APCA/WCAGチェック、失敗レポート、要求に応じた修正 | accessibility-contrast.md |
| 色域とTailwind | P3フォールバック、@themeスケール、色域クランプ | gamut-and-tailwind.md |
| 使用方法 | 意味的トークン、色ごとに1つの意味、プライマリアクションの強調、外観バリアント | color-usage.md |
基本原則
1. 知覚色空間を使用する
- 既存のシステムを尊重する。 このスキルが読み込まれたからといって、単に表記法を変換しないでください。カラーシステムの移行がタスクに含まれていない限り、プロジェクトの意味的トークンと作成形式を再利用してください。
- 知覚的均一性。 等しいLステップ = 等しい明るさ。
oklch(0.5 ...)は視覚的に中間です。HSLのlightness: 50%は色相によって大きく異なります。 - 安定した色相。 HSLの青は明度が変わると紫にシフトします。OKLCHの色相は明度範囲全体で一定です。
- 独立したクロマ。 クロマは明度に依存しない色鮮やかさの絶対的な尺度です。HSLの彩度は依存します。
- 有限の色域。 すべてのoklch値が表示可能なsRGB色にマッピングされるわけではありません。特定の色相の高クロマ値はクリップされます。色域の認識が必要です。
2. OKLCHを一貫して記述・フォーマットする
oklch(L C H)
oklch(L C H / alpha)
| チャンネル | 範囲 | 説明 |
|---|---|---|
| L (明度) | 0–1 | 0 = 黒, 1 = 白。知覚的に均一。 |
| C (クロマ) | 0–~0.4 | 色鮮やかさ。0 = グレー。最大値はLとHに依存。 |
| H (色相) | 0–360 | 色相角度(度)。 |
| alpha | 0–1 | オプションの透明度。スラッシュ構文。 |
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)
LとCは小数点以下3桁、Hは最大3桁を使用してください。末尾のゼロは削除し、-0 は 0 とフォーマットしてください。OKLCHはBaseline 2023です。サポート要件が異常に広範囲にわたる場合は、固定のグローバルカバレッジパーセンテージに頼るのではなく、対象プロジェクトのブラウザマトリックスを確認してください。
3. コントラスト、色域、パレットの動作を測定する
| ルール | 値 |
|---|---|
| ライト/ダーク境界 | L > 0.73 = 明るい背景 → 暗いテキスト。それ以下でも明るいテキストのスコアが高い場合あり |
| 明度差 (明るい背景) | 背景L > 0.9 の場合、前景L < 0.35 |
| 明度差 (暗い背景) | 背景L < 0.25 の場合、前景L > 0.9 |
| 色相ずれ閾値 | パレットステップ間で > 10° の広がり = 目に見えるずれ |
| APCA本文テキスト | |
| APCA非本文テキスト | |
| WCAG 2 通常テキスト | 4.5:1 AA, 7:1 AAA |
| コントラスト修正 (依頼された場合のみ) | 最初にLを調整。可能であればCとHを保持し、その後レンダリングペアを再測定 |
よくある間違い
| 問題 | 修正 |
|---|---|
| 生の色がプロジェクトの意味的トークンシステムをバイパスする | プロジェクトの既存の表記法で正しいロールトークンを再利用または追加する |
| 孤立したOKLCH値がhex/RGBコードベースに導入される | カラーシステム移行がタスクに含まれていない限り、確立された表記法を維持する |
| 色相ずれのあるHSLパレットランプ | 一定のoklch色相で再構築する |
| コントラスト不合格 (APCAを使用して前景とその背景を確認) | ペア、測定されたLc、および見逃しているしきい値を報告。変更は依頼された場合のみ行う(その場合Lを調整し、CとHを保持) |
| 色域チェックなしの高クロマ | sRGBのL/Hの最大クロマにクランプする |
| 異なる色相で同じ絶対C | 一貫した鮮やかさのために同じC%(最大クロマのパーセンテージ)を使用する |
| sRGBフォールバックなしのP3色 | @media (color-gamut: p3) パターンを追加する |
| ライトパレットを機械的に反転させて作成されたダークモード | ライトパレットを出発点として使用し、クロマと明度を調整し、すべての前景/背景ペアを再チェックする |
Tailwind v4 @theme 内のHex | oklch値に変換する |
| カンマ構文のアルファ | スラッシュを使用: oklch(L C H / alpha) |
| 同じ色相が2つの異なる意味を持つ(装飾的に再利用されたリンク色) | 一色一意。2番目の用途にはニュートラルを与える |
| その役割の外で使用される意味的トークン(テキストとしてのセパレータ) | 不足している役割のトークンを追加。値で借用しない |
| 1つのビューに複数の色付きコントロール背景 | 単一のプライマリアクションのみを塗りつぶす。セカンダリはニュートラルのまま |
| ライトモードでのみ検証されたパレット | 両方の外観ですべての前景/背景ペアを再チェックする |
レビュー出力形式
この形式は、ユーザーがスタンドアロンの色レビューを要求した場合にのみ使用してください。better-interfaceがレビューを調整する場合は、ドメインの証拠と調査結果をそのスキルに提供し、その出力形式、重大度スケール、統合ルール、上限、および判定を優先させてください。
スタンドアロンのレビューは2つの部分で提示します。
調査結果
確認された調査結果を原則ごとにグループ化します。重大度、場所、変更前、変更後、理由のカラムを持つマークダウンテーブルを使用します。「変更前:」/「変更後:」の個別行は絶対に使用しないでください。
- 重大度:
HIGHはコンテンツを読み取り不能にする、または誤解を招く意味的色を割り当てる。MEDIUMはテーマ、色域、または一貫性の顕著な障害を引き起こす。LOWは孤立した微調整。 - 場所:
path/to/file:lineを引用。アーティファクトにソースファイルがない場合は、正確な画面とコンポーネントを引用。 - 変更前/変更後: 現在の値またはトークンと、正確な置換を示す。
- 理由: 違反した原則の名前を挙げ、関連する場合は測定されたコントラストまたは色域の証拠を含める。
反復する体系的な問題は1行に統合し、影響を受けるすべての場所をリストします。調査結果のない原則は省略します。
| 重大度 | 場所 | 変更前 | 変更後 | 理由 |
|---|---|---|---|---|
| MEDIUM | src/theme.css:18 | color: #3b82f6 | color: oklch(0.623 0.188 259.815) | 新しいプロジェクトカラーはOKLCHトークンを使用 |
| MEDIUM | src/palette.ts:31 | 異なる色相で同じ絶対C | 各色相の最大クロマの同じC% | 等しいクロマ値は色相間で等しく鮮やかに見えない |
| HIGH | src/theme.css:52 | フォールバックなしのP3色 | @media (color-gamut: p3) の前にsRGBフォールバックを追加 | 色が非P3ディスプレイで失敗する |
検証と判定
調査結果の後:
- 検証: 実行された正確なチェックとその観測結果をリストアップします。コントラスト測定、色域チェック、および該当する場合はライトとダークの両方の外観を含めます。チェックが実行されなかった場合は、まだ検証が必要なものを記載します。
- 判定:
HIGHの調査結果が残っている場合はBlock、MEDIUMまたはLOWの調査結果のみの場合はNeeds changes、アクション可能な調査結果が残っていない場合のみApprove。
調査結果がない場合は、テーブルを省略し、「アクション可能な色の調査結果はありません」と述べ、検証を報告し、Approve で終了します。