2.0 KiB
2.0 KiB
04. Component System & Reuse
1. 原则
NEX 不要求安装或开发名为 NEX 的 UI 组件库。项目已有组件体系是优先实现载体。NEX 约束的是复用方式、组件职责和对用户可见的行为。
2. 先复用再新增
开发前查看已有基础组件、表单组件、布局组件、反馈组件、复合组件和业务组件。
决策顺序:
- 现有组件能力满足:直接复用;
- 缺少通用能力:向后兼容扩展;
- 多处重复出现且接口稳定:抽象共享组件;
- 单页特例:保留局部实现;
- 第三方组件已足够:不机械包装。
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*。只在复用收益明确时抽象。