nex_design_system/docs/04-layout-system.md

4.0 KiB
Raw Blame History

04. Layout System & Page Shells

1. 布局治理原则

NEX 统一的是布局的职责分离、信息层级、响应式和交互质量,不要求所有项目使用相同导航结构或像素尺寸。具体 Shell、导航形态、Header/Sider 尺寸、内容边距、断点和滚动策略由项目规范定义。

2. 页面类型识别

实施前先按用户主要任务识别页面类型,例如:

  • 管理型页面:列表、详情、编辑、设置、权限等。
  • 概览型页面:Dashboard、监控和分析。
  • 专业工作区:文档、聊天、流程、画布、IDE、媒体编辑等。
  • 独立入口:登录、分享、公开展示、向导等。

以上是分类参考,不要求项目必须拥有所有类型。不存在的类型标记 NOT_APPLICABLE。

3. Shell 模式(概念性,不是组件命名要求)

3.1 应用 Shell

适用于需要全局导航、模块切换和统一页面容器的产品。可采用侧边导航、顶部导航、混合导航或其他经过验证的模式。

职责建议:

  • 全局导航、当前上下文和用户入口清晰。
  • 导航区域与主内容区滚动行为明确。
  • 页面内容区域具有可预测的留白和宽度策略。
  • 导航折叠/展开状态可恢复,且键盘操作可达。

3.2 内容/文档工作区

仅在产品存在文档阅读、编辑或文件管理任务时采用。

  • 文件树、工具栏、编辑区/预览区职责分离。
  • 需要独立滚动时,应明确每个滚动容器的边界。
  • 编辑与预览应保持合理一致的内容宽度和阅读节奏。
  • 嵌套 Flex/Grid 子项在需要收缩时检查 min-width: 0、min-height: 0。

3.3 对话工作区

仅在产品存在 AI Chat 或多轮消息任务时采用。

  • 消息历史与输入区职责分离。
  • 输入区在长消息流中保持可达。
  • 会话列表、消息区和工具面板的滚动关系明确。
  • 停止、重试、复制、引用和工具执行状态可理解。

3.4 专业工作台/画布

适用于流程编辑、数据分析、多面板控制和复杂创作任务。

  • 主工作区优先获得足够空间。
  • 可折叠/可调整面板的状态可预测。
  • 拖拽操作应有键盘或其他非拖拽替代路径。
  • 不使用普通后台页面的最大宽度限制挤压画布,除非产品规范明确要求。

3.5 独立页面 Shell

适用于登录、公开分享、邀请和向导等无需完整应用导航的页面。保持品牌和组件语义一致,但不强制显示全局导航。

4. 普通业务页面的信息顺序

可按任务选择:

  1. 页面上下文/标题/面包屑。
  2. 关键指标(只有帮助判断时才展示)。
  3. 搜索、筛选、视图切换或批量操作。
  4. 主内容(表格、卡片、表单、详情或图表)。
  5. 帮助、审计信息或辅助说明。

不要为了填满空间添加没有业务价值的卡片或模块。

5. 响应式布局

  • 优先复用项目已有断点和组件库响应式规则。
  • 不强制采用某一固定断点数值;新增断点必须有真实布局需求和验证依据。
  • 明确桌面、平板、窄屏下导航、表格、表单、工具栏和多栏工作区的变化。
  • 不应简单缩小桌面布局来冒充移动端体验。
  • 避免无意的整页横向滚动;宽表格可按项目设计采用横向滚动或替代呈现。

6. 滚动与尺寸约束

  • 明确页面主滚动容器和嵌套工作区滚动容器。
  • 不要在多个祖先层级重复设置 overflow: auto/hidden 而不清楚滚动归属。
  • 检查长文本、长文件名、代码块、表格和媒体内容是否撑破布局。
  • 固定高度应有产品理由;优先使用父容器约束、弹性布局或视口计算。
  • 对 Flex/Grid 子项检查 min-width: 0 和 min-height: 0,但不要机械地全局添加。

7. 实施前必须记录

页面或 Shell 改造前,记录:

  • 当前 Shell 和导航行为;
  • 关键尺寸的权威来源;
  • 视口变化时的布局行为;
  • 滚动容器归属;
  • 受影响页面清单;
  • 现有视觉截图或可用回归检查。