3.8 KiB
3.8 KiB
适配说明: 本文描述跨项目交互原则和常见模式。具体组件、快捷键、反馈样式和操作路径以项目级规范及现有成熟实现为准。
06. NEX Interaction System
1. 交互一致性
NEX 把交互视为产品合同。同一种操作在不同模块中应保持相同触发方式、位置、状态变化、反馈和异常处理。
2. 页面操作层级
- Primary Action:当前页面最重要的一个操作,通常位于 PageHeader 右侧或表单 Footer。
- Secondary Action:辅助操作,采用次级按钮或文字按钮。
- Destructive Action:删除、撤销、转移所有权等不可逆/高风险操作,采用危险色并要求确认。
- Contextual Action:行内、卡片或对象级动作,默认不与主操作争夺视觉注意力。
同一视图原则上只设一个明显的主要动作;避免多个同等级实心主按钮并排。
3. 表单交互
- 标签清晰,必填标识一致;校验信息靠近对应字段。
- 校验既要在客户端进行,也要正确展示服务端错误。
- 提交期间禁用重复提交,并显示 Loading。
- 成功后给出明确反馈,并按照任务流关闭 Modal/Drawer 或跳转。
- 取消时若有未保存改动,必须确认或提供保留草稿机制。
- 长表单按业务主题分组;不要仅为视觉分段而过度使用 Card。
4. 搜索与筛选
- 简单搜索与高级筛选分层呈现。
- 搜索框位置、宽度策略、清空按钮和 Enter 行为在同类页面保持一致。
- 已应用筛选条件应可见;清空筛选要能恢复默认结果。
- 批量操作只在选择状态出现,并显示选中数量。
- 刷新与重置不是同一行为:刷新重新加载当前条件结果,重置清除条件。
5. 表格交互
- 列排序、筛选、分页和行选择必须有明确的状态反馈。
- 行点击用于进入详情时,行内菜单/按钮必须阻止事件冒泡,避免误跳转。
- 分页变更后是否保留选择需按数据类型明确规定;不得出现隐式丢失选择。
- 删除等危险操作不能仅依赖行内图标,必须有可理解的确认文案。
- 长文本显示省略时,需提供 Tooltip、详情或复制能力。
6. Modal / Drawer / Page 选择
| 场景 | 默认容器 |
|---|---|
| 简短确认、1–5 个字段的小表单 | Modal |
| 查看对象详细信息、侧向编辑、需要保留列表上下文 | Drawer |
| 长表单、多步骤流程、复杂向导、独立 URL | 独立页面 |
| 文件阅读、Markdown 编辑、PDF 预览 | 专用 Workspace |
| 需要持续对话的 AI 交互 | Conversation Workspace |
不要仅因为页面已经存在 Modal 组件,就把所有编辑功能塞入 Modal。
7. 反馈状态
每个异步交互至少考虑:
- Idle:默认状态。
- Loading:正在处理,防止重复触发。
- Success:成功结果和后续动作。
- Error:失败原因与恢复方式。
- Empty:没有数据或没有匹配结果。
- Disabled:明确不可用原因(必要时 Tooltip/帮助文本)。
反馈选择:
- 短暂、非阻塞操作:Message/Toast。
- 需要用户理解结果或采取动作:Notification 或页面内状态。
- 长时间后台任务:任务状态区域/进度视图,不只弹一个 Toast。
- 删除/权限等风险确认:Modal Confirm。
8. 主题切换
- 主题切换不应丢失当前页面上下文和输入状态。
- 所有自定义表面、文字、边框、悬停、选中、代码区和图表都要检查暗色主题。
- 禁止业务 CSS 为了暗色主题重新写一套与基础 token 不同的语义。
9. 动效
- 动效必须解释状态变化,例如展开、收起、切换、加载完成。
- 避免对普通卡片普遍使用大幅上浮和缩放。
- 尊重减少动态效果设置。