用途:这是一份面向 UI 构建与前端代码审查的设计工程原则清单,强调好界面由大量细节累积而成,适合在开发组件、实现动画或检查前端代码时参照。
主要能力:分为四类。排版方面:标题用 text-wrap: balance,正文用 text-wrap: pretty,动态数字用 font-variant-numeric: tabular-nums,macOS 根布局用 -webkit-font-smoothing: antialiased。表面方面:嵌套圆角遵循外半径=内半径+内边距的同心原则,图标做视觉对齐而非纯几何居中,用多层半透明 box-shadow 代替实线边框,图片加 1px 低透明度描边,交互元素点击区域至少 40×40px,不足时用伪元素扩展且不可重叠。动画方面:交互状态变化用 CSS 过渡以便中途打断,关键帧留给一次性的分阶段序列;入场动画按语义分块并以约 100ms 错开;退场更轻,用小的固定 translateY;图标切换用透明度、缩放与模糊变化(缩放 0.25→1、透明度 0→1、模糊 4px→0px),项目若含 motion 或 framer-motion 则用 transition: { type: "spring", duration: 0.3, bounce: 0 },bounce 必须为 0,否则保留两个图标并用 cubic-bezier(0.2, 0, 0, 1) 交叉淡入淡出;按钮按下用 scale(0.96) 反馈,不得小于 0.95,可用静态属性关闭;AnimatePresence 用 initial={false} 避免首次渲染播放动画。性能方面:禁止 transition: all,须指定具体属性;will-change 仅用于 transform、opacity、filter,不用 all,且只在出现首帧卡顿时添加。
使用方式:可作为构建与代码审查时的核对清单,逐项检查圆角、图标居中、阴影替代边框、入场错开、退场轻量、tabular-nums、字体平滑、标题 balance、图片描边、按压缩放、动画初始状态、过渡属性、will-change 与点击区域等。资料还提供 typography.md、surfaces.md、animations.md、performance.md 四个参考文件。
适用场景与限制:适用于网页前端 UI 的构建、动画实现与代码评审。具体依赖版本、安装步骤、收费方式与实测效果暂未提供。