效果与反馈规范
返回入口 · 文档整理版 0.1 · 2026-10-27
1. 范围
本次保留已有规范中的阴影、遮罩、叠放层级和轻量动效。参考教程中的玻璃效果、背景模糊、渐进模糊不在本次已核实的项目规范范围内,不补写为已完成资产。
阴影用于区分承载层级,遮罩用于弱化背景并突出前景;先选场景,再查现有参数,避免为装饰叠加效果。
2. 阴影档位(归档记录)
| 档位 | 值 | 场景 |
|---|---|---|
| shadow-sm | 0 1px 3px rgba(0,0,0,0.1) |
轻微提升:输入框聚焦、小卡片 |
| shadow-md | 0 4px 16px rgba(0,0,0,0.1) |
中等提升:下拉菜单、悬浮卡片 |
| shadow-lg | 0 8px 24px rgba(0,0,0,0.12) |
高提升:弹窗、浮层 |
| shadow-xl | 0 16px 48px rgba(0,0,0,0.2) |
最高提升:全屏弹窗 |
| shadow-up | 0 -4px 16px rgba(0,0,0,0.05) |
底部弹出面板 |
| shadow-focus | 0 0 0 4px #b3f6ee |
聚焦环 |
以上是文档中的名称与数值,不保证存在同名 CSS 类或变量。尤其 shadow-focus 是聚焦环记录,不能直接视为已确认的统一焦点样式,见差异清单。
3. 遮罩
使用颜色规范中的 overlay 角色,保持明暗对应。原组件章节将弹窗遮罩写为黑色 80%,与语义层的模态遮罩记录存在差异;本版不合并成一个默认值。涉及具体弹窗时确认目标组件,不直接覆盖其现有行为。
4. 层级档位(归档记录)
| 名称 | 值 | 场景 |
|---|---|---|
| z-base | 1 | 基础定位 |
| z-dropdown | 10 | 下拉菜单、工具提示 |
| z-sticky | 100 | 固定导航栏、吸顶 |
| z-popover | 200 | 弹出框、浮层 |
| z-modal | 1000 | 模态弹窗 |
| z-toast | 2000 | Toast、系统通知 |
这些是规范命名,不代表项目每个组件已改用同名变量或统一值。复用组件前查看其挂载位置与现有层级,避免只提升数字解决遮挡。
5. 动效(归档记录)
| 场景 | 时长 | 备注 |
|---|---|---|
| Hover 颜色变化 | 100ms | transition-colors |
| 标准过渡 | 150ms | duration-base |
| 弹窗动画 | 200ms | fade-in + scale 95%→100% |
| 出场动画 | 200ms | fade-out + scale 100%→95% |
克制原则:动效应微妙、不引人注目,避免过度动画。
6. 交互反馈与可读性
原规范覆盖 Hover、Active、Disabled、Error 和 Focus。悬停与选中引用现有语义色;移动端考虑触摸按下反馈;错误提示保留明确的状态信息。
历史聚焦环分别出现文字说明 3px、代码类 ring-2、阴影表 4px 的记录,尚未统一。不得直接复制“无 outline”而没有等效的可见焦点。
本次新增检查建议:实际检查键盘焦点、暗色下遮罩与前景分离、禁用状态可辨识性、动效是否妨碍内容阅读。以上是待执行的检查要求,不是已通过验收的结论;本次没有运行页面。
7. 待确认项
焦点环、弹窗遮罩与旧 Hover 固定色值的差异见差异清单。没有依据时不新增玻璃、模糊、渐进模糊、渐变或新的动画预设。