Tailwind CSS と Ignite UI for Angular の統合
Ignite UI for Angular は、CSS 変数を通じてテーマを完全にカスタマイズできます。このガイドでは、Tailwind CSS をプロジェクトに統合し、igniteui-theming パッケージが提供するカスタム ユーティリティ クラスを活用する方法を紹介します。これらのクラスは Ignite UI for Angular のデザイン トークンをユーティリティとして公開し、カラー・シャドウ・タイポグラフィの一貫したスタイリングを可能にします。
概要
このガイドでは、igniteui-theming を含む Ignite UI for Angular がすでにインストールされていることを前提としています。そうでない場合は、次を実行します。
ng add igniteui-angular
Tailwind のセットアップ
Tailwind とその PostCSS プラグインをインストールします。
npm install tailwindcss @tailwindcss/postcss postcss --force
次に、プロジェクトのルートに .postcssrc.json ファイルを作成し、PostCSS 構成に @tailwindcss/postcss プラグインを追加します。
{
"plugins": {
"@tailwindcss/postcss": {}
}
}
Tailwind をセットアップしたら、Tailwind と Ignite UI テーマ設定の両方をグローバル スタイルシート (styles.css または styles.scss)にインポートします。
@import "tailwindcss";
@import "igniteui-theming/tailwind/themes/base";
プロジェクトでスタイル設定に Sass を使用している場合は、最初に Ignite UI 構成を読み込みます。Sass では、@use ルールを @import などのほかのどのルールよりも前に書く必要があるためです。
@use "igniteui-theming/tailwind/themes/base.css";
@import "tailwindcss";
Ignite UI カスタム ユーティリティ クラスの使用
igniteui-theming パッケージには、Ignite UI のデザイン トークンをユーティリティ クラスとして公開する Tailwind のカスタム設定が含まれています。これには以下が含まれます:
-
カラーとコントラスト カラー
-
エレベーション (シャドウ)
-
タイポグラフィ スタイル
それぞれの使い方を見ていきましょう。
カラー ユーティリティ クラス
当社のカラー ユーティリティ クラスは、各 Ignite UI テーマのトークンを活用しています。これらを HTML に直接適用できます。
<h1 class="bg-primary-500 text-primary-500-contrast">This is a title</h1>
Tailwind の完全なカラー システムは Tailwind カラーのドキュメントで確認でき、Ignite UI が提供するクラス名を使って適用できます。
シャドウ ユーティリティ クラス
定義済みのエレベーション レベル (0 ~ 24) のいずれかを使用して深度を追加できます。
<div class="shadow-elevation-8">Elevated container</div>
Tailwind が提供するすべてのシャドウ関連のユーティリティ クラスは、Tailwind ボックス シャドウのドキュメントで見つけることができます。
タイポグラフィ カスタム ユーティリティ スタイル
フォントを適用するには、トップ レベルの要素に font-ig クラスを追加します。text-base ユーティリティ クラスを使用して基本フォント サイズを定義することもできます。
各タイポグラフィ レベル (例: h1、h2、body-1) ごとにカスタム ユーティリティ クラスを提供しています。以下のように使用してください。
<p class="type-style-h3">This paragraph gets the h3 styles</p>
各クラスは、Ignite UI のタイプ スケールに応じて、必要なすべてのフォント設定、間隔、サイズを適用します。
これらのカスタム タイポグラフィ ユーティリティは、ig-typography の外でのみ動作します。トップ レベルの要素に ig-typography CSS クラスを設定する必要がある場合、これらのスタイルは適用されません。
サンプル
以下のサンプルでは、shadows、colors、typography 用のカスタム ユーティリティを含む、Tailwind ユーティリティ クラスのみを使用して構築された 404 ページが表示されます。
各コンポーネントのスタイル設定方法は、それぞれのドキュメント トピックのスタイル設定セクションで確認できます。
このサンプルは架空の完全カスタム例であり、Ignite UI コンポーネント ライブラリの一部ではありません。
まとめ
わずか数ステップの設定で、Tailwind のユーティリティ ファースト アプローチと Ignite UI の堅牢なデザイン システムを組み合わせることができます。この統合により、カラー・エレベーション・タイポグラフィのトークンを直接 HTML で活用し、一貫性のあるテーマ付き UI コンポーネントを迅速に構築できます。
関連リソース
コミュニティに参加して新しいアイデアをご提案ください。