4.0 KiB
4.0 KiB
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. 普通业务页面的信息顺序
可按任务选择:
- 页面上下文/标题/面包屑。
- 关键指标(只有帮助判断时才展示)。
- 搜索、筛选、视图切换或批量操作。
- 主内容(表格、卡片、表单、详情或图表)。
- 帮助、审计信息或辅助说明。
不要为了填满空间添加没有业务价值的卡片或模块。
5. 响应式布局
- 优先复用项目已有断点和组件库响应式规则。
- 不强制采用某一固定断点数值;新增断点必须有真实布局需求和验证依据。
- 明确桌面、平板、窄屏下导航、表格、表单、工具栏和多栏工作区的变化。
- 不应简单缩小桌面布局来冒充移动端体验。
- 避免无意的整页横向滚动;宽表格可按项目设计采用横向滚动或替代呈现。
6. 滚动与尺寸约束
- 明确页面主滚动容器和嵌套工作区滚动容器。
- 不要在多个祖先层级重复设置
overflow: auto/hidden而不清楚滚动归属。 - 检查长文本、长文件名、代码块、表格和媒体内容是否撑破布局。
- 固定高度应有产品理由;优先使用父容器约束、弹性布局或视口计算。
- 对 Flex/Grid 子项检查
min-width: 0和min-height: 0,但不要机械地全局添加。
7. 实施前必须记录
页面或 Shell 改造前,记录:
- 当前 Shell 和导航行为;
- 关键尺寸的权威来源;
- 视口变化时的布局行为;
- 滚动容器归属;
- 受影响页面清单;
- 现有视觉截图或可用回归检查。