Ignite UI for Blazor のテーマ
Ignite UI for Blazor には、Bootstrap、Material、Fluent、Indigo の 4 つの異なるテーマが付属しています。すべてのコンポーネント テーマはコンポーネントに組み込まれていますが、パレット、タイポグラフィ、およびその他のグローバル構成を機能させるには、グローバル スタイル ファイルが必要です。
テーマの読み込み
テーマを有効にするには、テーマ ファイルを読み込む必要があります。プロジェクトの構成に応じて、インポートまたはリンクすることができます。
バンドルされているすべてのテーマとそのパスの完全なリストは次のとおりです:
| 名前 | バリアント | 場所 |
|---|---|---|
| Bootstrap | ライト | _content/IgniteUI.Blazor/themes/light/bootstrap.css |
| Material | ライト | _content/IgniteUI.Blazor/themes/light/material.css |
| Fluent | ライト | _content/IgniteUI.Blazor/themes/light/fluent.css |
| Indigo | ライト | _content/IgniteUI.Blazor/themes/light/indigo.css |
| Bootstrap | ダーク | _content/IgniteUI.Blazor/themes/dark/bootstrap.css |
| Material | ダーク | _content/IgniteUI.Blazor/themes/dark/material.css |
| Fluent | ダーク | _content/IgniteUI.Blazor/themes/dark/fluent.css |
| Indigo | ダーク | _content/IgniteUI.Blazor/themes/dark/indigo.css |
Sass によるカスタマイズ
上記のテーマ ファイルはビルド済みの CSS であり、このセクションのトピックでは CSS 変数をオーバーライドしてカスタマイズします。パレット、タイポグラフィ、エレベーション、および構成を参照してください。この方法ではビルド構成は不要で、ほとんどのカスタマイズに対応できます。
ビルド済みのテーマは、すべての Ignite UI for Blazor テーマの基盤となる Sass ライブラリ igniteui-theming からコンパイルされており、同じライブラリをアプリケーションでも使用できます。一部の機能は、変数を通じてではなくコンパイル時に実行されるため、このライブラリからのみ利用できます:
igniteui-theming を使用した Sass ビルドはプレーンな CSS を生成します。これは --ig-* 変数のスタイルシートで、独自の CSS オーバーライドと同じように、テーマ ファイルの後に読み込みます。フレームワークには Sass コンパイラーを実行する手段だけが必要です。両方のパッケージをインストールします:
npm install igniteui-theming sass --save-dev
次に、.scss ファイルでライブラリをインポートします:
@use 'igniteui-theming' as *;
// Required for $material-type-scale, $indigo-type-scale, and similar preset variables
@use 'igniteui-theming/sass/typography/presets' as *;
// Required for $material-elevations and $indigo-elevations
@use 'igniteui-theming/sass/elevations/presets' as *;
:root {
@include palette(palette($primary: #0099ff, $secondary: #df1b74, $surface: #ffffff));
}
スタイルシートのコンパイル
Blazor プロジェクトには JavaScript バンドラーがないため、npm スクリプトやビルド前の手順などから Sass コマンド ラインでスタイルシートをコンパイルし、結果を wwwroot に書き込みます:
npx sass --load-path=node_modules Styles/theme.scss wwwroot/css/theme.css
ホスト ページで、テーマ ファイルの後にコンパイル済みファイルをリンクします:
<link href="_content/IgniteUI.Blazor/themes/light/bootstrap.css" rel="stylesheet" />
<link href="css/theme.css" rel="stylesheet" />
@use 'igniteui-theming' as *; が解決されない場合は、Sass コンパイラーのロード パスに node_modules が含まれていません。Sass コマンド ラインには --load-path=node_modules を渡すか、Vite では css.preprocessorOptions.scss.loadPaths を、Next.js では sassOptions.loadPaths を設定してください。
Sass ツールチェーンを使用しない場合
出力をアプリケーションと一緒に再ビルドする必要はありません。スタイルシートを一度コンパイルして CSS をコミットし、Sass を変更したときにのみ再コンパイルします。Theming MCP サーバーでも、ローカルの Sass コンパイラーなしで、パレットとコンポーネント テーマをすぐに使用できる CSS として生成できます。