nex_design_system/docs/07-page-patterns.md

3.3 KiB
Raw Blame History

适配说明: 以下页面模式是可选参考,不是功能清单。项目不存在的类型应标记 NOT_APPLICABLE,不得为满足文档而创建页面或组件。现有项目模式优先。

07. NEX Page Patterns

1. Dashboard / Overview

组成:PageHeader(可用 Hero)→ 关键指标 → 趋势/图表 → 最近活动或重点数据。

规则:

  • 只展示可帮助决策的指标;指标卡建议控制在一行可读范围内。
  • 指标卡使用统一网格;屏幕变窄时逐级降列。
  • 图表、表格和指标使用一致的数据时间范围与筛选上下文。
  • 页面不应堆叠没有业务关联的多个卡片。

2. Data List / 列表页

推荐结构:

PageHeader(标题、说明、主操作)
SearchToolbar(搜索、筛选、重置、刷新、视图)
SelectionToolbar(仅有选中数据时显示)
DataTable 或 CardGrid
Pagination(如不由 DataTable 承载)

规则:

  • 列表页标题和搜索操作不要混为一个视觉层级。
  • 过滤器位置和展开方式稳定。
  • 表格滚动由页面可用空间决定,不能写死统一像素高度。
  • 卡片网格可以用于对象浏览,但必须定义卡片信息优先级和统一高度策略。
  • 空数据、首次创建和搜索无结果是不同状态,不能用同一种 Empty 文案。

3. Detail / 详情页

组成:返回/面包屑 → 对象标题与状态 → 主要操作 → 摘要信息 → Tabs/分区详情 → 审计/关联信息。

规则:

  • 先说明“这是哪个对象、处于什么状态”,再展示详细字段。
  • 重要状态始终可见;危险操作收纳在次级操作菜单或明确危险区域。
  • 长详情使用分区,不要把所有字段放入单张长表格。

4. Form / 创建与编辑页

规则:

  • 标题表达当前任务(创建/编辑具体对象)。
  • 字段按用户心智模型分组,而非按数据库字段顺序排列。
  • 主操作与取消始终固定在一致位置。
  • 保存失败保留用户已输入数据。
  • 需要复杂帮助或动态配置时使用分步/分组,不应把长表单压进窄 Modal。

5. Settings / 配置页

规则:

  • 分类导航与配置内容分区清晰。
  • 每个配置组有标题、用途说明和独立保存边界(如适用)。
  • 破坏性/高风险配置与普通偏好设置分离。
  • 未保存状态需要可见。

6. Document Workspace

规则:

  • 文件树、文档上下文、正文画布、工具栏职责清楚。
  • 正文宽度和行长稳定;代码、表格、图片等可在画布内滚动。
  • 阅读模式与编辑模式共享字体、标题层级、列表、表格和代码样式。
  • 目录定位、搜索高亮、滚动恢复等专业行为要有稳定状态。

7. Conversation Workspace

规则:

  • 会话历史与当前消息区分区明确。
  • 输入区域固定;附件、模型、项目、发送/停止状态集中组织。
  • 引用来源与普通正文有明显层级,但不抢占正文阅读。
  • 助手生成中、工具调用中、失败和可重试状态可区分。

8. Auth / Share 页面

规则:

  • 认证页聚焦唯一任务,不显示无关导航。
  • 分享页面明确标注访问对象、权限和有效性。
  • 对没有权限、链接失效、对象不存在等状态给出不同提示。