Tailwind CSS ディレクティブと関数

Tailwind CSS は、開発者がスタイルをより適切に管理し、コードを最適化するのに役立つ、非常に便利な関数とディレクティブをいくつか提供しています。

関数とディレクティブを通じて、Tailwind は、特にスタイルのカスタマイズ、レスポンシブデザインの処理、機能の拡張などにおいて、より多くの制御と柔軟性を提供します。

Tailwind CSS は、開発者がスタイルを管理およびカスタマイズするためのさまざまなディレクティブと関数を提供しています:

  • 使用@tailwindTailwind のベーススタイル、コンポーネントスタイル、ユーティリティクラスを導入します。
  • @apply複数のユーティリティクラスをカスタムクラスに組み合わせて、スタイルの重複を避けることができます。
  • @layerカスタム CSS 内で異なるレイヤースタイルを整理および定義できます。
  • 組み込みの色、間隔、透明度、角丸などの関数を使用して、スタイルを動的に計算および生成できます。

@tailwind ディレクティブ

@tailwindこのディレクティブは、CSS ファイルに Tailwind の3つの主要なコアレイヤーを導入するために使用されます:base, componentsとutilities。

  • @tailwind base:Tailwind のベーススタイル(ブラウザのリセットスタイルなど)を導入します。
  • @tailwind components:ボタン、カード、フォームなどの基本スタイルを定義するためのコンポーネントスタイルを導入します。
  • @tailwind utilities:ユーティリティクラスを導入します。これは Tailwind スタイルライブラリの中核部分であり、レイアウト、色、間隔、枠線などのための低レベルのユーティリティクラスを提供します。

これらのレイヤーは、Tailwind を使用する際に必要なすべての基本スタイル、コンポーネントスタイル、ユーティリティクラスを定義します。

/* 自定义样式中引入 Tailwind 样式 */
@tailwind base;          /* 引入基础样式 */
@tailwind components;    /* 引入组件样式 */
@tailwind utilities;     /* 引入工具类 */

@apply ディレクティブ

@applyこのディレクティブは、カスタム CSS クラス内で Tailwind のユーティリティクラスを適用するために使用されます。これにより、Tailwind の保守性と柔軟性を維持しながら、よく使用するスタイルを組み合わせることができます。

.my-class {
  @apply <utility-class1> <utility-class2> ... ;
}

例

/* カスタムボタンクラス */
.btn {
  @apply px-4 py-2 bg-blue-500 text-white rounded-lg;
}

/* カスタム警告ボタンクラス */
.btn-warning {
  @apply px-4 py-2 bg-yellow-500 text-black rounded-lg;
}

を使用することで@apply、よく使用するクラスを1つのカスタム CSS クラスに組み合わせることができ、繰り返し使用できます。

@layer ディレクティブ

@layerこのディレクティブは、Tailwind 内でレイヤーを定義するために使用され、主にカスタム拡張スタイルの整理に使用されます。通常、カスタムコンポーネントやユーティリティクラスなどを作成して、CSS ファイルの構造を明確に保つために使用されます。

  • @layer components:カスタムコンポーネントを定義します。
  • @layer utilities:カスタムユーティリティクラスを定義します。
  • @layer base:ベーススタイルを定義します。

構文形式:

@layer components {
  /* 在这里定义自定义的组件类 */
}

@layer utilities {
  /* 在这里定义自定义的工具类 */
}

例

/* カスタムボタンコンポーネントの定義 */
@layer components {
  .btn {
    @apply px-4 py-2 bg-blue-500 text-white rounded-lg;
  }
}

/* カスタムユーティリティクラスの定義 */
@layer utilities {
  .no-scrollbar {
    @apply overflow-hidden;
  }
}

@import ディレクティブ

Tailwind CSS では、@importディレクティブを使用して他の CSS ファイルを導入することもできます。Tailwind 自体は頻繁に使用することを推奨していませんが、@importこの機能は引き続きサポートされています。

構文形式:

@import '<path-to-file>';

Tailwind CSS の関数

Tailwind CSS の関数は、主に色、透明度、サイズなどの計算といったスタイルを動的に生成するために使用されます。これらにより、設定ファイルやカスタムスタイル内でより多くの計算と制御を行うことができます。

色関数 (Color Functions)

Tailwind は、色のさまざまなバリエーション(暗くする、明るくするなど)を生成するために使用できる組み込みの色関数をいくつか提供しています。

  • darken():色を暗くします。
  • lighten():色を明るくします。
  • opacity():色の透明度を設定します。

例

/* lighten 関数を使用して色を明るくする */
.bg-custom-lighten {
  background-color: lighten(#3490dc, 10%);
}

/* darken 関数を使用して色を暗くする */
.bg-custom-darken {
  background-color: darken(#3490dc, 10%);
}

/* opacity 関数を使用して透明度を設定する */
.bg-custom-opacity {
  background-color: rgba(52, 144, 220, 0.8);
}

間隔関数 (Spacing Functions)

Tailwind は、rem, px, emなどの単位の関数を提供しています。これらを使用して、動的なサイズや間隔の値を計算できます。

例

/* rem 関数を使用してルートフォントサイズに基づく間隔を設定する */
.margin-4 {
  margin: rem(4);
}

/* px 関数を使用して間隔を設定する */
.padding-10px {
  padding: px(10);
}

角丸関数 (Border Radius Functions)

Tailwind CSS では、関数を使用して角丸を設定することもできます。例えば、radius()を使用して、さまざまな角丸を計算します。

例

/* radius 関数を使用して角丸を設定する */
.rounded-custom {
  border-radius: radius(8px);
}

カスタム関数 (Custom Functions)

Tailwind CSS では、カスタム関数を定義して使用できます。tailwind.config.js内で、theme関数を使用して Tailwind のデザインシステムにアクセスして操作できます。例えば、色、間隔、フォントなどを動的に生成できます。

例

// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        'custom-green': '#1064B9', // 色コードを直接使用する
      },
      spacing: {
        '1/3': '33.333333%',  // カスタム間隔単位
      },
    },
  },
};

Tailwind CSS の一般的な組み込み関数

Tailwind CSS には、カスタムスタイルを構築する際の計算に役立つ関数が多数組み込まれています。

以下は、一般的な組み込み関数の一部です:

関数機能の説明例
rem()指定されたピクセル値をrem単位に変換します。ルートフォントサイズ(デフォルト16px)に基づきます。rem(16) → 1rem
em()指定されたピクセル値をem単位に変換します。現在の要素のフォントサイズに基づきます。em(16) → 1em
px()指定された数値をpx単位に変換します。px(16) → 16px
calc()Tailwind CSS で CSScalc()関数を使用して動的な計算を行います。calc(100% - 20px)
min()2つの値のうち最小値を取得します。min(10px, 5vw) → 5vw
max()2つの値のうち最大値を取得します。max(10px, 5vw) → 10px
clamp()を生成します。clamp()関数は、レスポンシブなフォントサイズと間隔の設定によく使用されます。clamp(1rem, 5vw, 3rem)→ レスポンシブなフォントサイズを動的に生成します
theme()Tailwind の設定内のテーマ値(色、間隔、フォントなど)にアクセスします。theme('colors.blue.500') → #3b82f6
screen()レスポンシブデザインに適した画面サイズのブレークポイントを返します。screen('md') → @media (min-width: 768px)

rem() の例:

/* 将数字 16 转换为 rem 单位 */
.my-class {
  font-size: rem(16);  /* 结果为 1rem */
}

em() の例:

/* 将数字 16 转换为 em 单位 */
.my-class {
  padding: em(16);  /* 结果为 1em */
}

px() の例:

/* 使用 px() 函数生成固定像素 */
.my-class {
  margin: px(16);  /* 结果为 16px */
}

calc() の例:

/* 使用 calc() 函数动态计算 */
.my-class {
  width: calc(100% - px(20));  /* 结果为 100% - 20px */
}

theme() の例:

/* 使用 theme() 函数访问 Tailwind 主题配置 */
.my-class {
  background-color: theme('colors.green.500');  /* 结果为 #1064B9 */
}

clamp() の例:

/* 使用 clamp() 设置字体大小,基于视口宽度变化 */
.my-class {
  font-size: clamp(1rem, 5vw, 3rem);  /* 最小 1rem,最大 3rem,视口宽度介于其间时动态变化 */
}

条件演算子と関数の組み合わせを使用する

Tailwind では、多くの機能を条件演算子と一緒に使用できます。レスポンシブデザインと状態クラス(例:hover:, focus:)を組み合わせると、これらのスタイルを動的に適用できます。

例えば、@applyとレスポンシブデザインを組み合わせて、特定の機能を実装できます:

例

/* レスポンシブと状態クラスを組み合わせたカスタムスタイル */
.button {
  @apply py-2 px-4 bg-blue-500 text-white rounded-md;
}

/* 中程度の画面サイズでは、ボタンの背景色が緑色になります */
@media (min-width: 768px) {
  .button:hover {
    background-color: #4882BB; /* Tailwind の緑色を使用 */
  }
}
その他の拡張