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