angular-tailwind

Angular + Tailwind CSS

版本： Tailwind CSS 4.x（2025） 标签： Tailwind CSS、样式、实用优先、CSS

参考： Tailwind CSS • Angular Tailwind

API 变更

本节介绍近期特定版本的 API 变更。

• 新增：Tailwind CSS v4 — 采用性能更佳的新引擎 来源

• 新增：@tailwindcss/vite — 原生支持 Vite

• 新增：CSS 优先配置 — 使用 CSS 而非配置文件配置 Tailwind

• 新增：支持 Angular 17+ — 完全兼容独立组件

最佳实践

• 安装 Tailwind CSS

npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init

• 配置 tailwind.config.js

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    "./src/**/*.{html,ts}",
  ],
  theme: {
    extend: {},
  },
  plugins: [],
}

• 在样式中添加指令

@tailwind base;
@tailwind components;
@tailwind utilities;

• 在 Angular 中使用 Tailwind v4

npm install tailwindcss @tailwindcss/vite

// vite.config.ts
import tailwindcss from '@tailwindcss/vite';

export default defineConfig({
  plugins: [tailwindcss()],
});

@import "tailwindcss";

• 在模板中使用实用类

@Component({
  template: `
    <div class="flex items-center justify-between p-4 bg-white shadow rounded-lg">
      <h1 class="text-2xl font-bold text-gray-800">Title</h1>
      <button class="px-4 py-2 bg-blue-500 text-white rounded hover:bg-blue-600">
        Click
      </button>
    </div>
  `
})
export class CardComponent {}

• 使用 ngClass 设置条件类

@Component({
  template: `
    <div [ngClass]="isActive ? 'bg-blue-500' : 'bg-gray-200'">
      Content
    </div>
  `
})
export class MyComponent {}

• 使用类绑定

@Component({
  template: `
    <div [class]="containerClasses">
      Content
    </div>
  `
})
export class MyComponent {
  containerClasses = 'p-4 bg-white rounded-lg shadow';
}

• 使用 Tailwind 创建自定义组件

@Component({
  selector: 'app-button',
  template: `
    <button [class]="buttonClasses">
      <ng-content></ng-content>
    </button>
  `
})
export class ButtonComponent {
  @Input() variant: 'primary' | 'secondary' = 'primary';
  
  get buttonClasses() {
    const base = 'px-4 py-2 rounded font-medium transition';
    const variants = {
      primary: 'bg-blue-500 text-white hover:bg-blue-600',
      secondary: 'bg-gray-200 text-gray-800 hover:bg-gray-300'
    };
    return `${base} ${this.variants[this.variant]}`;
  }
}

• 使用 @apply 创建可复用样式

@layer components {
  .btn-primary {
    @apply px-4 py-2 bg-blue-500 text-white rounded hover:bg-blue-600;
  }
  
  .card {
    @apply bg-white rounded-lg shadow p-4;
  }
}

• 使用主题自定义

// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        brand: {
          50: '#f0f9ff',
          500: '#0ea5e9',
          900: '#0c4a6e',
        }
      }
    }
  }
}

• 使用深色模式

// tailwind.config.js
module.exports = {
  darkMode: 'class',
}

@Component({
  template: `
    <div class="dark:bg-gray-900 dark:text-white">
      Content
    </div>
  `
})
export class DarkComponent {}