# 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*`。只在复用收益明确时抽象。