nex_design_system/docs/04-component-system.md

2.0 KiB
Raw Permalink Blame History

04. Component System & Reuse

1. 原则

NEX 不要求安装或开发名为 NEX 的 UI 组件库。项目已有组件体系是优先实现载体。NEX 约束的是复用方式、组件职责和对用户可见的行为。

2. 先复用再新增

开发前查看已有基础组件、表单组件、布局组件、反馈组件、复合组件和业务组件。

决策顺序:

  1. 现有组件能力满足:直接复用;
  2. 缺少通用能力:向后兼容扩展;
  3. 多处重复出现且接口稳定:抽象共享组件;
  4. 单页特例:保留局部实现;
  5. 第三方组件已足够:不机械包装。

3. 组件职责

  • Foundation:Token、主题、字体、图标、焦点样式;
  • Primitive:Button、Input、Select 等基础控件;
  • Composite:页面标题、筛选栏、数据工具栏、统计区;
  • Pattern:列表、编辑流程、工作区等页面组合。

以上是职责分类,不要求固定目录、命名或必须全部实现。

4. 常见组件设计契约

Page Heading

标题、说明、导航上下文和主操作层级明确;窄屏下不能相互挤压。

Search / Filter

搜索、筛选、重置和应用行为一致;已应用条件可见;批量操作只在有选中项时呈现。

Data Table / List

列优先级清晰;行点击与行内操作不冲突;分页、排序、选择行为符合项目约定;窄屏保留关键数据和操作。

Form

标签、必填、帮助信息和错误信息关系清楚;提交中避免重复触发;取消时明确未保存内容处理方式。

Modal / Drawer / Overlay

根据任务复杂度选择容器;焦点进入与返回、关闭方式和层级行为符合交互语义。

Feedback / Status

状态不只依赖颜色;截断的重要内容应有可获取的完整名称;装饰图标不混入可访问名称;图标按钮使用描述动作的业务名称,不暴露内部 glyph 名。

5. 避免重复抽象

不要仅为统一命名把已有 PageHead、Ctlbar、DataTable 重命名为 Nex*。只在复用收益明确时抽象。