nex_design_system/docs/04-component-system.md

50 lines
2.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

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