tailwind-ui

使用 WCAG 2.1 AA 无障碍性、主题和暗黑模式支持的最佳实践进行 Tailwind CSS v4.1 开发。用于处理 HTML、CSS、样式组件、无障碍性(a11y)、WCAG 兼容性、颜色对比、焦点状态、屏幕阅读器、主题、浅色模式和暗黑模式,或构建可访问的 UI 模式,如按钮、表单、卡片和导航。与 angular-best-practices 技能互补,用于 Angular 前端。

📖 中文导读:使用 WCAG 2.1 AA 无障碍性、主题和暗黑模式支持的最佳实践进行 Tailwind CSS v4.1 开发。用于处理 HTML、CSS、样式组件、无障碍性(a11y)、WCAG 兼容性、颜色对比、焦点状态、屏幕阅读器、主题、浅色模式和暗黑模式,或构建可访问的 UI 模式,如按钮、表单、卡片和导航。与 angular-best-practices 技能互补,用于 Angular 前端。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: tailwind-ui description: Tailwind CSS v4.1 best practices with WCAG 2.1 AA accessibility, theming, and dark mode support. Use when working with HTML, CSS, styling components, accessibility (a11y), WCAG compliance, color contrast, focus states, screen readers, theming, light mode, dark mode, or building accessible UI patterns like buttons, forms, cards, and navigation. Complements the angular-best-practices skill for Angular frontends.

Tailwind UI Skill

Tailwind CSS v4.1 development with accessibility and theming baked in.

Quick Reference

v4.1 Critical Changes

Never use deprecated utilities — always use replacements:

Deprecated Replacement
bg-opacity-* bg-black/50 (opacity modifier)
bg-gradient-* bg-linear-*
shadow-sm shadow-xs
shadow shadow-sm
rounded-sm rounded-xs
rounded rounded-sm
ring ring-3
outline-none outline-hidden
leading-* Use text-base/7 line-height modifiers
flex-shrink-* / flex-grow-* shrink-* / grow-*
space-x-* in flex/grid Use gap-* instead

Essential Patterns

<!-- Gap over space utilities -->
<div class="flex gap-4">...</div>

<!-- Opacity modifiers -->
<div class="bg-primary-500/60">...</div>

<!-- Line height modifiers -->
<p class="text-base/7">...</p>

<!-- Dynamic viewport height (mobile-safe) -->
<div class="min-h-dvh">...</div>

<!-- Size utility for equal dimensions -->
<div class="size-12">...</div>

Reference Files

Load these based on the task:

Theme Asset

Core Principles

  1. Use Tailwind's scale — Avoid arbitrary values like ml-[16px]; use ml-4
  2. Never use @apply — Use CSS variables or framework components
  3. Gap over margins — Use gap-* in flex/grid, not space-* or child margins
  4. Test both modes — Always verify light AND dark mode appearance
  5. Accessibility first — Every interactive element needs visible focus states and proper contrast