基线UI
强制执行一套有观点的UI基线,防止AI生成的界面质量低下。
使用方法
-
/baseline-ui在当前对话中,对所有UI工作应用这些约束。 -
/baseline-ui <文件>根据以下所有约束审查该文件,并输出:- 违规内容(引用确切的行/代码片段)
- 为什么重要(一句简短的话)
- 具体修复方法(代码级建议)
技术栈
- 必须使用 Tailwind CSS 默认值,除非已存在自定义值或被明确要求
- 必须使用
motion/react(原framer-motion)来实现 JavaScript 动画 - 应该使用
tw-animate-css来实现 Tailwind CSS 中的入场和微动效 - 必须使用
cn工具函数(clsx+tailwind-merge)来处理类名逻辑
组件
- 必须使用可访问的组件基元来处理任何涉及键盘或焦点行为的交互(
Base UI、React Aria、Radix) - 必须优先使用项目中已有的组件基元
- 绝不在同一个交互界面中混用不同的基元系统
- 如果与当前技术栈兼容,应该优先选择
Base UI作为新的基元 - 必须为仅包含图标的按钮添加
aria-label - 除非明确要求,绝不要手动实现键盘或焦点行为
交互
- 对于破坏性或不可逆的操作,必须使用
AlertDialog - 应该为加载状态使用结构化的骨架屏
- 绝不要使用
h-screen,改用h-dvh - 固定元素必须考虑
safe-area-inset - 错误提示必须在用户操作发生的位置附近显示
- 绝不要阻止用户在
input或textarea元素中粘贴内容
动画
- 除非明确要求,绝不要添加动画
- 只能对合成属性(
transform、opacity)进行动画 - 绝不对布局属性(
width、height、top、left、margin、padding)进行动画 - 应该避免对绘制属性(
background、color)进行动画,除非是局部的小型UI元素(文本、图标) - 应该使用
ease-out作为入场缓动 - 交互反馈动画时长绝不超过
200ms - 当循环动画离开屏幕时必须暂停
- 应该尊重用户的
prefers-reduced-motion设置 - 除非明确要求,绝不要引入自定义缓动曲线
- 应该避免对大型图片或全屏表面进行动画
排版
- 标题必须使用
text-balance,正文/段落必须使用text-pretty - 数据展示必须使用
tabular-nums - 密集的UI应该使用
truncate或line-clamp - 除非明确要求,绝不要修改
letter-spacing(tracking-*)
布局
- 必须使用固定的
z-index层级体系(不允许使用任意的z-*) - 正方形元素应该使用
size-*而不是w-*+h-*
性能
- 绝不对大面积使用
blur()或backdrop-filter进行动画 - 绝不在动画之外应用
will-change - 绝不要用
useEffect来实现任何可以通过渲染逻辑表达的功能
设计
- 除非明确要求,绝不要使用渐变
- 绝不要使用紫色或多色渐变
- 绝不要将发光效果作为主要交互暗示
- 除非明确要求,应该使用 Tailwind CSS 默认的阴影体系
- 空状态必须提供一个清晰的下一个操作
- 每个视图应尽量将强调色控制在一种
- 在引入新颜色之前,应该优先使用现有主题或 Tailwind CSS 的颜色令牌