UI 组件创建技能
shadcn/ui + 设计系统模式
使用时机:创建新的 UI 组件
重要:首先阅读设计系统
在生成任何 UI 之前:阅读 /DESIGN-SYSTEM.md
质量门:以下方面至少达到 9/10 分:
- 视觉独特性
- 品牌一致性
- 可访问性
模式:shadcn/ui 组件
'use client';
import { Card } from '@/components/ui/card';
import { Button } from '@/components/ui/button';
export function MyComponent({ data }: { data: any }) {
return (
<Card className="p-6 border-border-subtle bg-bg-card">
<h2 className="text-xl font-semibold text-text-primary mb-4">
{data.title}
</h2>
<p className="text-text-secondary mb-4">
{data.description}
</p>
<Button variant="default" className="bg-accent-500 hover:bg-accent-600">
操作
</Button>
</Card>
);
}
设计 Token(必需)
使用以下 Token,而非原始值:
颜色:
bg-bg-card(而非bg-white)text-text-primary(而非text-gray-900)accent-500(#ff6b35 橙色)border-border-subtle
间距:
- Tailwind 类(p-4、mb-6 等)
禁止使用的模式
❌ bg-white(请使用 bg-bg-card)
❌ text-gray-600(请使用 text-text-secondary)
❌ 无响应式的 grid grid-cols-3 gap-4(请添加 md:、lg:)
必需的模式
✅ 使用设计系统中的 Token ✅ 所有状态(悬停、聚焦、禁用) ✅ 响应式断点 ✅ 可访问性(aria-labels)
标准:使用设计 Token,实现所有状态,确保可访问性