返回作品 · 规范文档
本文目录

效果与反馈规范

返回入口 · 文档整理版 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 固定色值的差异见差异清单。没有依据时不新增玻璃、模糊、渐进模糊、渐变或新的动画预设。

基于项目设计经验后续整理,供开发与 AI 查阅;实际接入效果待验证。