パレット生成
Ignite UI for React のパレット生成は、シード カラーを、シェード間のコントラストが予測可能なシェードのファミリに変換する igniteui-theming の palette 関数です。
概要
すべての Ignite UI for React パレットは、少数のシードカラー (primary、secondary、surface、および任意で gray、info、success、warn、error) から始まります。igniteui-theming Sass ライブラリの palette() 関数は、各シードをシェードのファミリに展開します。カラー ファミリには、50 から 900 までの 10 個の番号付きシェードと、A100 から A700 までの 4 個のアクセント シェードがあります。gray ファミリには番号付きシェード 10 個のみがあり、surface ファミリには番号の代わりに名前付きレイヤーがあります。すべてのシェードには対応する -contrast カラーもあり、シード自体は seed バリアントとして保持されます。
ビルド済みの Ignite UI for React テーマはこの関数でコンパイルされているため、Sass を記述しなくても、表示されるカラーはこの関数によって決まります。この関数には 2 つのジェネレーターがあります:
| ジェネレーター | ファミリの構築方法 | 使用場所 |
|---|---|---|
legacy |
シードを 500 に配置し、その HSL の彩度と明度に固定値を乗算して他のシェードを求めます。シェードは 500 の CSS 相対カラーとして出力されます。 |
すべてのビルド済み CSS テーマと、事前定義された Sass パレット。 |
fitted |
各シェードを WCAG コントラスト ターゲットに基づいて求め、彩度はシードの色相が表現できる範囲に収めます。各シェードは固定カラーとして出力されます。 | Sass の palette() で生成するパレットのデフォルト。 |
このセクションの残りの部分では、fitted ジェネレーターの動作と、そのシェードがそのように動作する理由を説明します。
シードとスケール
legacy ジェネレーターはすべてのシェードをシードの開始明度に結び付けるため、ファミリの品質はシードの位置に依存します。非常に暗いシード hsl(210 80% 10%) から開始すると、生成される最も明るいシェードは #012d5a であり、ファミリのすべてのシェードが暗くなります。非常に淡いシード hsl(210 80% 90%) から開始すると、シェード 50 から 300 までの乗算された明度が 100% を超えるため、4 つすべてが白に解決され、最も暗いシェードは #2793ff にしか達しません。
fitted ジェネレーターは、シードの特性とファミリの構造を分離します。シードは色相と、ファミリのカラフルさを提供します。スケールは、シェードの到達範囲と間隔を提供します。同じ 2 つのシードから、fitted ジェネレーターはそれぞれ 10 個の異なるシェードを生成します。暗いシードからは #e4ecf8 から #0a1623、淡いシードからは #e4edf7 から #0b1621 です。
番号付きシェードはスケールから位置を取得するため、シードがそのいずれかにちょうど一致することはまれです。シードは seed バリアント (--ig-primary-seed) として引き続き利用できるため、ブランド カラーそのものが失われることはありません。彩度がほとんどないニュートラルに近いシードからは、元にない強い色味が加わることなく、わずかな色合いを残したニュートラルなファミリが生成されます。
色相とガマット
HSL の明度が同じ 2 つのカラーが、同じ明るさに見えるわけではありません。HSL の明度 50% の黄色は、50% の青よりもはるかに明るく見えます。fitted ジェネレーターは、明度と彩度が知覚により近く対応する OKLCH で動作し、明度の数値ではなく WCAG コントラストですべてのシェードを測定します。
カラーが持てる彩度の量は、色相と明度に依存し、白と黒に近づくにつれて狭くなります。淡い青は、表示可能な sRGB カラーのまま中間調の青と同じようにカラフルであり続けることはできません。fitted ジェネレーターは、色相の sRGB 境界内で各ファミリを構築します。スケールの両端に向かって彩度を絞り、各コントラスト ターゲットに到達する明度を求め、カラーを sRGB にマッピングした後でそのコントラストを測定します。アクセント シェードも同じ方法で求めますが、アクセント専用の固定コントラスト ターゲットを使い、彩度を色相が表現できる限界まで上げるため、鮮やかさが保たれます。
コントラスト ターゲット
スケールは、カラー ファミリでは白に対して測定されるコントラスト ターゲットのリストです。デフォルトのスケール even は、50 の 1.18:1 から 900 の 18.23:1 までで、各ターゲットに同じ比率を乗算して次のターゲットを求めます。2 つのシェード間のコントラストは、白に対するそれぞれのコントラストの比であるため、隣接するシェード間の比率が等しいということは、同じ距離だけ離れた任意の 2 つのシェードが同じコントラストを持つことを意味します。
even では、5 つ離れたシェードは、通常テキストの WCAG AA 最小値 (英語)である 4.5:1 を満たします。50 と 500、100 と 600、200 と 700、300 と 800、400 と 900 です。これにより、シードが変わっても成り立つ組み合わせのルールが得られます:
.status {
background: var(--ig-primary-100);
color: var(--ig-primary-600);
}
このルールは、even で構築されたファミリの番号付きシェードに適用されます。任意の組み合わせ、半透明のカラー、カスタム スケール、またはデフォルトの gray スケールには適用されません (グレーとページを参照)。組み合わせに依存する場合は、必ずレンダリングされた前景色と背景色を確認してください。
スケールの形状
スケールには 2 つの主なコントロールがあります。range は、最初と最後のシェードのコントラスト ターゲットを設定します。任意の curve は、CSS の cubic-bezier() タイミング関数と同じ 4 つの制御点を使用して、その間のシェードを再配分します。x はシェード間の位置、y は範囲内の位置です。curve がない場合、シェードは均等に配置されます。
igniteui-theming には 4 つのプリセットが付属しています:
| プリセット | 形状 | 5 ペア AA ルール |
|---|---|---|
even |
1.18:1 から 18.23:1 までの均等な間隔。gray を除くすべてのファミリのデフォルト。 |
5 ペア中 5 ペア |
material |
元の Ignite UI グレースケールに合わせて調整。gray のデフォルト。 |
白に対して 5 ペア中 3 ペア |
tailwind |
Tailwind CSS v4 の slate スケールに合わせて調整。 | 5 ペア中 5 ペア |
carbon |
IBM Carbon のグレー スケールに合わせて調整。 | 5 ペア中 5 ペア |
プリセットはパレットではなくリズムを借用しており、カラーはシードが提供します。カスタムの range または curve はコントラスト構造を変更するため、5 ペア ルールは自動的には成り立たなくなります。範囲が狭い場合や、シェードを近接させる curve では、ペアが 4.5:1 を下回ることがあります。
グレーとページ
白いページでは控えめなグレーも、暗いページでは目立つことがあります。そのため、gray ファミリは 3 番目のスケール設定である anchor を読み取り、範囲を何に対して測定するかを設定します:
anchor: 'surface'は、サーフェス カラーに対して測定します。シェード50はページに最も近いままで、番号が大きいほどページから離れます (ライト テーマでは暗く、ダーク テーマでは明るく)。これは、even、tailwind、carbon、および記述したスケールのデフォルトです。anchor: 'white'は、元のグレースケールの構築方法と同様に、白に対して測定します。10 個のグレーはどのテーマでも同じカラーで、暗いサーフェスでは逆順に並び、50が最も暗くなります。grayのデフォルトであるmaterialプリセットはこの anchor を使用するため、既存のダーク テーマをfittedジェネレーターに移行しても、コンポーネントの外観は変わりません。
いずれの場合も、番号が小さいほどページとのコントラストが低くなります。$gray を渡さない場合、gray のシードは、ライト サーフェスでは黒、ダーク サーフェスでは白になります。
anchor が 'surface' のスケールは、サーフェスが許容するよりも高いコントラストを要求することがあります。暗いグレーのページに対する白では、白と黒の間で得られる 21:1 に到達できません。その場合、ジェネレーターは到達できる最も近いシェードを返し、結果がターゲットを 5% を超えて下回ると Sass の警告を出力します。
サーフェス ロール
surface ファミリはシェードのランプではありません。サーフェスは、インターフェイスの中で何かがどこに位置するかを表すため、このファミリは名前付きのロールのセットです:
| ロール | CSS 変数 | 説明 |
|---|---|---|
base |
--ig-surface-base |
ページの背景。サーフェス シードそのもの。 |
sunken |
--ig-surface-sunken |
ページに埋め込まれたレイヤー。黒に 1 ステップ近づけます。 |
raised |
--ig-surface-raised |
ページの上のレイヤー。白に 1 ステップ近づけます。 |
overlay |
--ig-surface-overlay |
メニューやダイアログなどの浮動レイヤー。白により大きく近づけます。 |
container |
--ig-surface-container |
半透明のレイヤー。ライト サーフェスでは黒、ダーク サーフェスでは白。 |
十分に動く余地のないロールは base カラーに解決されます。純白のサーフェスでは、raised と overlay も白になり、純黒のサーフェスでは、sunken も黒になります。その場合、境界線またはエレベーションで区別します。白や黒に近いサーフェスでは、わずかに余地が残っていても同じことが起こる場合があります:
base |
sunken |
raised |
overlay |
|---|---|---|---|
rgb(255, 255, 255) |
rgb(247, 247, 247) |
base と同じ |
base と同じ |
rgb(240, 240, 245) |
rgb(234, 232, 237) |
rgb(250, 249, 254) |
base と同じ |
rgb(0, 0, 0) |
base と同じ |
rgb(13, 13, 13) |
rgb(23, 23, 23) |
各ロールに固有のカラーが必要な場合は、白または黒から少し離れたサーフェス シードを選択し、生成された --ig-surface-* 変数を確認してください。
どちらのジェネレーターも同じロールを出力し、コンポーネント テーマはそれらを通じて surface を参照します。color($color: 'surface') はデフォルトで base を返します。半透明の container のコントラスト カラーは、base に重なった状態の色に対して測定されます。コンテナー上のテキストは、実際にはこの重なった色の上に表示されるためです。
すべてのパレットは、番号付きで記述されたスタイルが引き続き解決されるように、--ig-surface-500 などの番号付きの surface シェードも出力します。これらは非推奨であり、将来のリリースで削除されます。fitted パレットでは、--ig-surface-500 は --ig-surface-base を指し、他の番号付きシェードはそこから派生します。legacy パレットでは、従来どおりサーフェス シードから派生します。
開始する前に
2 つのジェネレーターは実行時の動作が異なるため、作業対象のパレットがどちらのジェネレーターで生成されたかを確認してください:
- ビルド済み CSS テーマと、事前定義された Sass パレット (
$light-material-paletteなど) はlegacyジェネレーターを使用します。そのシェードは500の CSS 相対カラーであるため、--ig-primary-500をオーバーライドすると、ビルド手順なしでブラウザーでファミリ全体が更新されます。パレットを参照してください。 - Sass の
palette()で生成するパレットは、デフォルトでfittedジェネレーターを使用します。そのシェードはビルド時に計算される固定カラーです。1 つの変数をオーバーライドしても、そのシェードのみが変更されます。ファミリを変更するには、新しいシードでパレットを再生成します。
パレットを生成するには、igniteui-theming パッケージと Sass コンパイラー (「Sass によるカスタマイズ」を参照)が必要です。ジェネレーターは Sass ビルド中にのみ実行され、アプリケーションには結果の CSS 変数だけが含まれます。
次のステップ
- 実行時に CSS 変数でパレット カラーをオーバーライドする: パレット。
- Sass からのみ利用できるコントラスト関数とチャート パレット関数を使用する: アクセシビリティ。
- Ignite UI for React 用に Sass をセットアップする: Sass によるカスタマイズ。
利用可能なツール
| ツール | 目的 |
|---|---|
palette() 関数 |
シード カラーからパレット マップを構築します。ジェネレーターと各ファミリのスケールを選択するための $generator と $scales を受け取ります。 |
palette() ミックスイン |
パレット マップを --ig-* CSS 変数として出力します。 |
$shade-generator |
ビルド内のすべての palette() 呼び出しのデフォルト ジェネレーターを設定します: 'fitted' (デフォルト) または 'legacy'。 |
$scales |
スケール プリセット: even、material、tailwind、carbon。 |
$family-scales |
各ファミリのデフォルト スケール。リストにないファミリは even を使用し、gray は material を使用します。 |
color() および contrast-color() 関数 |
シェードまたはそのコントラスト カラーを、CSS 変数参照として、またはパレット マップから読み取ります。 |
一般的なワークフロー
パレットの生成
fitted ジェネレーターでパレットを生成し、CSS 変数として出力します。このスタイルシートは、その変数が優先されるように、ビルド済みテーマの後に読み込みます。
@use 'igniteui-theming' as *;
$brand: palette(
$primary: #0099ff,
$secondary: #df1b74,
$surface: #ffffff
);
:root {
@include palette($brand);
}
パレットはビルド時に計算されるため、$primary、$secondary、$surface 引数は必須で、CSS 変数ではなく Sass カラーである必要があります。
スケールの選択
1 つのファミリ、またはすべてのファミリに対してプリセットを指定します:
// The grays follow IBM Carbon's rhythm; every other family keeps its default
$brand: palette(#0099ff, #df1b74, #ffffff, $scales: ('gray': 'carbon'));
// Every family uses the tailwind preset
$brand: palette(#0099ff, #df1b74, #ffffff, $scales: 'tailwind');
または、range、curve、gray の場合は anchor を使用してスケールをインラインで記述します:
$brand: palette(
#0099ff,
#df1b74,
#121212,
$scales: (
'primary': (range: 1.1 14, curve: 0.5 0 0.8 0.8),
'gray': (range: 1.1 14, anchor: 'white')
)
);
legacy ジェネレーターの維持
1 つのパレットで、乗数ベースのシェードと 500 からの実行時の派生を維持します:
$brand: palette(#0099ff, #df1b74, #ffffff, $generator: 'legacy');
ビルド内のすべての palette() 呼び出しを切り替えるには、ほかのどの @use よりも先に、igniteui-theming を with 付きで読み込みます:
@use 'igniteui-theming' as * with ($shade-generator: 'legacy');
トラブルシューティング
--ig-primary-500 をオーバーライドしても、他のプライマリ シェードが変更されなくなったのはなぜですか? パレットが fitted ジェネレーターで生成されたためです。このジェネレーターは、すべてのシェードを 500 の相対カラーではなく固定カラーとして出力します。新しいシードで Sass のパレットを再生成するか、500 からの実行時の派生が必要な場合は $generator: 'legacy' で生成してください。
--ig-surface-500 は引き続き使用すべきですか? いいえ。番号付きのサーフェス シェードは非推奨であり、互換性のためにのみ保持されています。それぞれの参照を、目的に合ったロールにマップしてください。通常、ページの背景には --ig-surface-base を使用します。
--ig-surface-raised と --ig-surface-overlay が --ig-surface-base と同じカラーになるのはなぜですか? サーフェス シードが白に近すぎて、それらのロールが動く余地が十分にないため、base に解決されます。これは白やそれに近いサーフェスで発生します。レイヤーは境界線またはエレベーションで区別するか、各ロールに固有のカラーが必要な場合は、少し暗いサーフェス シードを選択してください。サーフェス ロールを参照してください。
Shade "gray-900" wanted 18.232:1 but its hue only reaches 15.68:1 とはどういう意味ですか? スケールが、カラーとその anchor が許容するよりも高いコントラストを要求しています。最も多いのは、ダーク サーフェス上で anchor が 'surface' のグレー スケールを使う場合です。その場合、ジェネレーターは到達できる範囲で最も近いシェードを使用しています。範囲の上限を下げるか、スケールの anchor を 'white' にしてください。
関連リソース
FAQ
いいえ。ビルド済みの Ignite UI for React テーマと、事前定義された Sass パレットは legacy ジェネレーターで構築されているため、そのカラーと実行時の動作は変わりません。fitted ジェネレーターは、Sass の palette() 関数で生成するパレットに適用されます。
いいえ。ビルド済みの Ignite UI for React テーマには生成済みのパレットがすでに含まれており、CSS 変数をオーバーライドして実行時に変更できます。Sass が必要になるのは、fitted ジェネレーターやカスタム スケールなどで新しいパレットを生成する場合のみです。
fitted パレットでコントラストが自動的に確保されるわけではありませんが、予測はしやすくなります。デフォルトの even スケールでは、カラー ファミリ内で 5 つ離れたシェードは通常テキストの WCAG AA 最小値 4.5:1 を満たしますが、デフォルトの gray スケールでは白に対してそれら 5 ペアのうち 3 ペアが満たし、カスタム スケールではさらに少なくなることがあります。使用するすべての前景色と背景色の組み合わせを、レンダリングされたインターフェイスで確認してください。
fitted パレットは、各ファミリの seed バリアント (例: --ig-primary-seed) として正確なシード カラーを保持します。番号付きシェードはスケールによって配置されるため、シードは通常、500 やその他のシェードとちょうど一致しません。
いいえ。Ignite UI for React のパレット生成は Sass ビルド中に実行され、アプリケーションは結果の CSS 変数のみを受け取ります。ブラウザーによって CSS 相対カラーとして解決されるのは、-contrast カラーだけです。