Close
Angular React Web Components Blazor Blazor
Open Source

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 として生成できます。