nex_design_system/docs/03-layout-and-responsive.md

2.1 KiB
Raw Blame History

03. Layout, Navigation & Responsive Design

1. 布局原则

NEX 统一布局职责、信息层级和跨尺寸体验,不统一具体 Shell、导航形态、像素尺寸或断点。项目级 UI 规范决定具体实现。

2. 页面与工作区类型

按项目实际需要选择:

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

项目不存在的页面类型不需要引入模板。

3. Shell 与导航

  • 当前所在模块、路由和用户上下文清楚。
  • 导航区与内容区的滚动职责明确。
  • 桌面导航偏好与移动端临时 Drawer 状态可以采用不同生命周期。
  • 小屏导航应为内容保留空间,不应简单缩小桌面侧栏。
  • 当前选中状态和菜单名称清楚,关键导航可通过键盘操作。

4. 响应式设计

  • 优先沿用项目已有断点体系。
  • 断点由内容和组件最小可用宽度决定,不按设备型号机械划分。
  • 如需增加断点,采用语义化命名并集中登记;不得在页面随意散落互不关联的媒体查询。
  • 小屏重新组织信息和操作,不只是缩小桌面布局。
  • 工具栏应允许折行、收纳次要操作或转为菜单。
  • 表格应按数据任务选择:保留关键列、折叠次要信息、横向滚动、卡片化或详情展开。不得让关键字段和行操作在窄屏消失。
  • 长文本、长文件名、代码块和媒体内容不得撑破主布局。
  • 复杂工作区应明确主滚动容器、面板收缩和溢出处理。

5. 布局尺寸与滚动

  • Header、Sider、内容留白、最大宽度和控件尺寸以项目规范为准。
  • 关键尺寸应有清晰来源,避免 CSS、组件属性和主题配置互相冲突。
  • 复杂 Flex/Grid 区域合理处理 min-width: 0、min-height: 0。
  • 避免在多个祖先层级无理由叠加 overflow: auto/hidden。
  • 固定高度应有产品理由,优先使用弹性布局和内容约束。