nex_design_system/docs/07-page-patterns.md

82 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

> **适配说明:** 以下页面模式是可选参考,不是功能清单。项目不存在的类型应标记 `NOT_APPLICABLE`,不得为满足文档而创建页面或组件。现有项目模式优先。
# 07. NEX Page Patterns
## 1. Dashboard / Overview
组成:PageHeader(可用 Hero)→ 关键指标 → 趋势/图表 → 最近活动或重点数据。
规则:
- 只展示可帮助决策的指标;指标卡建议控制在一行可读范围内。
- 指标卡使用统一网格;屏幕变窄时逐级降列。
- 图表、表格和指标使用一致的数据时间范围与筛选上下文。
- 页面不应堆叠没有业务关联的多个卡片。
## 2. Data List / 列表页
推荐结构:
```text
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 页面
规则:
- 认证页聚焦唯一任务,不显示无关导航。
- 分享页面明确标注访问对象、权限和有效性。
- 对没有权限、链接失效、对象不存在等状态给出不同提示。