|
| 1 | +--- |
| 2 | +title: {Platform} の Tailwind 統合 |
| 3 | +_description: Ignite UI のテーマ エンジンのカスタム ユーティリティ クラスと Tailwind CSS を統合する方法について説明します。このガイドでは、セットアップの手順を説明し、ユーティリティ ファーストのアプローチでカラー、タイポグラフィ、シャドウのデザイン トークンを使用する方法について説明します。 |
| 4 | +_keywords: {ProductName}, Infragistics, Themes, Styling, Tailwind CSS, custom CSS, utility classes, theming engine, typography, shadows, colors, スタイル, テーマ設定, カスタム CSS, ユーティリティ クラス, テーマ設定エンジン, タイポグラフィ, シャドウ, カラー, インフラジスティックス |
| 5 | +mentionedTypes: ["ConfigureTheme"] |
| 6 | +_language: ja |
| 7 | +--- |
| 8 | + |
| 9 | +# Tailwind CSS と Ignite UI for WebComponents の統合 |
| 10 | +Ignite UI for WebComponents は、CSS 変数を通じて完全なテーマ カスタマイズを提供します。このガイドでは、Tailwind CSS をプロジェクトに統合し、`igniteui-theming` パッケージが提供するカスタム ユーティリティ クラスを活用する方法を紹介します。これらのクラスは Ignite UI のデザイン トークンをユーティリティとして公開し、カラー・シャドウ・タイポグラフィの一貫したスタイリングを可能にします。 |
| 11 | +<br> |
| 12 | + |
| 13 | +## 概要 |
| 14 | + |
| 15 | +このガイドでは、**Ignite UI Theming** がすでにインストールされていることを前提としています。そうでない場合は、次を実行します。 |
| 16 | + |
| 17 | +```cmd |
| 18 | +npm install igniteui-theming |
| 19 | +``` |
| 20 | + |
| 21 | +## Tailwind のセットアップ |
| 22 | + |
| 23 | +まず、[公式の Tailwind インストール ガイド](https://tailwindcss.com/docs/installation)に従って、選択したビルド ツールまたはフレームワークに応じて Tailwind CSS をインストールします。 |
| 24 | + |
| 25 | +Tailwind をセットアップしたら、Tailwind と Ignite UI テーマ設定の両方をグローバル スタイルシートにインポートします。 |
| 26 | + |
| 27 | +```css |
| 28 | +@import 'tailwindcss'; |
| 29 | +@import 'igniteui-theming/tailwind/theme'; |
| 30 | +``` |
| 31 | + |
| 32 | +プロジェクトでスタイル設定に `sass` を使用している場合: |
| 33 | + |
| 34 | +```scss |
| 35 | +@import "tailwindcss"; |
| 36 | +@use "igniteui-theming/tailwind/theme"; |
| 37 | +``` |
| 38 | + |
| 39 | +## Ignite UI カスタム ユーティリティ クラスの使用 |
| 40 | +`igniteui-theming` パッケージには、Ignite UI のデザイン トークンをユーティリティ クラスとして公開する Tailwind のカスタム設定が含まれています。これには以下が含まれます: |
| 41 | + |
| 42 | +- カラーとコントラスト カラー |
| 43 | + |
| 44 | +- エレベーション (シャドウ) |
| 45 | + |
| 46 | +- タイポグラフィ スタイル |
| 47 | + |
| 48 | +それぞれの使い方を見ていきましょう。 |
| 49 | + |
| 50 | +### カラー ユーティリティ クラス |
| 51 | +当社のカラー ユーティリティ クラスは、各 Ignite UI テーマのトークンを活用しています。これらを HTML に直接適用できます。 |
| 52 | + |
| 53 | +<!-- WebComponents --> |
| 54 | +```html |
| 55 | +<h1 class="bg-primary-500 text-primary-500-contrast">This is a title</h1> |
| 56 | +``` |
| 57 | +<!-- end: WebComponents --> |
| 58 | + |
| 59 | +Tailwind の完全なカラー システムは[こちら](https://tailwindcss.com/docs/color)で確認でき、Ignite UI が提供するクラス名を使って適用できます。 |
| 60 | +<br> |
| 61 | + |
| 62 | +### シャドウ ユーティリティ クラス |
| 63 | + |
| 64 | +定義済みの[エレベーション レベル](https://jp.infragistics.com/products/ignite-ui-web-components/web-components/components/themes/elevations) (0 ~ 24) のいずれかを使用して深度を追加できます。 |
| 65 | + |
| 66 | +<!-- WebComponents --> |
| 67 | +```html |
| 68 | +<div class="shadow-elevation-8">Elevated container</div> |
| 69 | +``` |
| 70 | +<!-- end: WebComponents --> |
| 71 | + |
| 72 | +Tailwind が提供するすべてのシャドウ関連のユーティリティ クラスは、[こちら](https://tailwindcss.com/docs/box-shadow)で見つけることができます。 |
| 73 | +<br> |
| 74 | + |
| 75 | +### タイポグラフィ カスタム ユーティリティ スタイル |
| 76 | +フォントを適用するには、トップ レベルの要素に `font-ig` クラスを追加します。`text-base` ユーティリティ クラスを使用して基本フォント サイズを定義することもできます。 |
| 77 | +各タイポグラフィ レベル (例: h1、h2、body-1) ごとにカスタム ユーティリティ クラスを提供しています。以下のように使用してください。 |
| 78 | + |
| 79 | +<!-- WebComponents --> |
| 80 | +```html |
| 81 | +<p class="type-style-h3">This paragraph gets the h3 styles</p> |
| 82 | +``` |
| 83 | +<!-- end: WebComponents --> |
| 84 | + |
| 85 | +各クラスは、[Ignite UI のタイプ スケール](https://jp.infragistics.com/products/ignite-ui-web-components/web-components/components/themes/typography)に応じて、必要なすべてのフォント設定、間隔、サイズを適用します。 |
| 86 | + |
| 87 | +## サンプル |
| 88 | + |
| 89 | +以下のサンプルでは、`shadows`、`colors`、`typography` 用のカスタム ユーティリティを含む、Tailwind ユーティリティ クラスのみを使用して構築された 404 ページが表示されます。 |
| 90 | + |
| 91 | +`sample="/layouts/tailwind/styling", height="400", alt="{Platform} Tailwind の統合"` |
| 92 | + |
| 93 | +>[!NOTE] |
| 94 | +>このサンプルは架空の完全カスタム例であり、Ignite UI コンポーネント ライブラリの一部ではありません。 |
| 95 | +
|
| 96 | +## まとめ |
| 97 | +わずか数ステップの設定で、Tailwind のユーティリティ ファースト アプローチと Ignite UI の堅牢なデザイン システムを組み合わせることができます。この統合により、カラー・エレベーション・タイポグラフィのトークンを直接 HTML で活用し、一貫性のあるテーマ付き UI コンポーネントを迅速に構築できます。 |
0 commit comments