nex_design_system/docs/06-interaction-system.md

3.8 KiB
Raw Blame History

适配说明: 本文描述跨项目交互原则和常见模式。具体组件、快捷键、反馈样式和操作路径以项目级规范及现有成熟实现为准。

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. 动效

  • 动效必须解释状态变化,例如展开、收起、切换、加载完成。
  • 避免对普通卡片普遍使用大幅上浮和缩放。
  • 尊重减少动态效果设置。