已有 directory API，原先缺少独立使用路径。
验收重点：选择目录后列出文件；普通多选入口可替代；无网络请求。
Element Plus 参考案例 ↗逐组件对照
Some documentation on this page is available in Chinese only. Component built-in messages follow English; untranslated example text remains in its original language.
逐组件对照
按开发任务归类组件：先认识基础与布局，再进入输入、选择、表单、数据管理和业务场景。每个组件都列出当前 Cedar 的展示重点、可操作示例，以及其他组件库的参考案例。
Vue 组件库用于比较使用与交互，React / Angular 组件库用于借鉴场景和示例组织。参考链接固定到工作区源码版本；“相关组合”表示职责相近的组合示例，不能据此认定对方缺少该能力。
101 个组件入口11 个分类10 套参考库
值得补充的重要内容（15 项）
复用 useUploader.addFiles，避免引入重复的上传状态机。
验收重点：仅拦截带文件的粘贴；校验类型、数量、大小；文本粘贴不受影响。
Chakra UI 参考案例 ↗单独加载动画不足以说明异步提交过程。
验收重点：演示校验失败、重复点击、请求失败后重新提交及加载结束。
Naive UI 参考案例 ↗持久化属于应用职责，可以用完整示例展示受控尺寸的接入。
验收重点：调整后保存；重新进入恢复；窄屏时恢复入口仍可用。
shadcn-vue 参考案例 ↗适合后台系统的页面跳转、操作检索和键盘优先工作流。
验收重点：先验证现有 Search、Menu、Dialog 的组合；再决定独立 API。
shadcn-vue 参考案例 ↗新用户引导需要目标定位、高亮遮罩与连续步骤。
验收重点：覆盖目标消失、滚动定位、跳过、完成与键盘退出。
Element Plus 参考案例 ↗已有 formatter / parser，应强调显示文本与业务数值的分工。
验收重点：覆盖空值、负数、小数、粘贴与光标编辑，不把格式化字符串写入数字模型。
Element Plus 参考案例 ↗现有能力分别展示后，还需证明组合过程的值与请求不会互相覆盖。
验收重点：快速切词、慢请求后返回、切换只读及初始 ID 回显；检查请求与最终值。
PrimeNG 参考案例 ↗范围选择与业务保存规则需要在同一示例中被看见。
验收重点：展示最短时长、跨日、手输无效、取消后模型保持；只使用已有规则。
Element Plus 参考案例 ↗把表单校验、步骤状态与返回修改串成可重复操作的流程。
验收重点：校验通过才能继续，回退保留数据，最终提交失败可重试。
PrimeNG 参考案例 ↗已有纵向虚拟列表不能直接推导出所有动态高度组合都通过。
验收重点：长文本换行、展开行、列宽调整后检查测量、滚动位置和固定列对齐。
Element Plus 参考案例 ↗单功能 demo 之外，重点验证异步节点与可见列表的状态衔接。
验收重点：搜索时加载节点、清空搜索、按业务值定位，并核对勾选与展开。
PrimeNG 参考案例 ↗已有容量与保存控制应在完整工作流中统一验证。
验收重点：远程加载、跨资源调整、容量拒绝、修正重试及撤销重做。
Vuetify 参考案例 ↗业务表单常同时出现抽屉、选择面板和确认框。
验收重点：Esc 只关闭当前层，关闭被拒绝时继续编辑，最终回到触发入口。
Element Plus 参考案例 ↗主题切换应连同移到其他容器的浮层一起展示。
验收重点：同时打开弹层并切换品牌和亮暗；检查局部覆盖、禁用和错误状态。
Naive UI 参考案例 ↗找到 101 个组件，当前展示 12 个。参考案例来自工作区源码，链接固定到对应提交。
基础与操作
16 个现有示例Button 按钮
同组子组件 / 接口：ButtonGroup
同组对比五档尺寸、变体与主题色；演示异步操作及失败恢复。
本库示例主题：尺寸、变体与外观、禁用与只读、加载与异步、键盘与焦点、布局与响应式、定制与组合、边界与恢复
相似功能点逐项对照（9 项）
尺寸与密度 已有示例
变体与视觉层次 已有示例
禁用与只读 已有示例
文档依据：| disabled | 禁用；省略时继承按钮组，显式 false 可覆盖 | `boolean` | `undefined` |
键盘操作与焦点 已有示例
插槽与自定义内容 已有示例
加载状态与重复操作 已有示例
图标与图文组合 已有示例
异步操作与失败恢复 已有示例
对照其他组件库的示例 10 套参考
Vuetify ↗Vue 多端 · 同类组件 · 32 份示例源码
参考示例主题：尺寸、变体与外观、禁用与只读、定制与组合
Quasar ↗Vue 多端 · 同类组件 · 20 份示例源码
参考示例主题：尺寸、变体与外观、禁用与只读、定制与组合
shadcn-vue ↗Vue 组合式 · 同类组件 · 25 份示例源码
参考示例主题：尺寸、变体与外观、定制与组合
MUI ↗React 设计参考 · 同类组件 · 36 份示例源码
参考示例主题：尺寸、变体与外观、加载与异步、定制与组合
Chakra UI ↗React 组合参考 · 同类组件 · 22 份示例源码
参考示例主题：尺寸、变体与外观、禁用与只读、加载与异步、布局与响应式、定制与组合
基础与操作
9 个现有示例Icon 图标
尺寸、颜色、旋转与动态图标切换。
本库示例主题：尺寸、定制与组合、边界与恢复
相似功能点逐项对照（4 项）
变体与视觉层次 待核验增量
对照其他组件库的示例 6 套参考
Vuetify ↗Vue 多端 · 同类组件 · 7 份示例源码
MUI ↗React 设计参考 · 同类组件 · 18 份示例源码
参考示例主题：尺寸
Chakra UI ↗React 组合参考 · 同类组件 · 11 份示例源码
参考示例主题：尺寸、变体与外观、定制与组合
基础与操作
9 个现有示例Link 链接
原生链接、禁用拦截、加载和键盘焦点。
本库示例主题：尺寸、禁用与只读、加载与异步
相似功能点逐项对照（6 项）
变体与视觉层次 待核验增量
禁用与只读 已有示例
文档依据：| disabled | 链接是否禁用 | `boolean` | `false` |
插槽与自定义内容 待核验增量
对照其他组件库的示例 6 套参考
Quasar ↗Vue 多端 · 同类组件 · 20 份示例源码
参考示例主题：尺寸、变体与外观、禁用与只读、定制与组合
MUI ↗React 设计参考 · 同类组件 · 6 份示例源码
Chakra UI ↗React 组合参考 · 同类组件 · 7 份示例源码
参考示例主题：变体与外观
基础与操作
7 个现有示例Typography 排版
同组子组件 / 接口：TypographyParagraph、TypographyText、TypographyTitle
标题、段落、省略、复制与编辑。
本库示例主题：边界与恢复
相似功能点逐项对照（3 项）
对照其他组件库的示例 6 套参考
Naive UI ↗Vue 桌面 · 同类组件 · 4 份示例源码
shadcn-vue ↗Vue 组合式 · 同类组件 · 7 份示例源码
参考示例主题：禁用与只读
MUI ↗React 设计参考 · 同类组件 · 4 份示例源码
Chakra UI ↗React 组合参考 · 同类组件 · 7 份示例源码
参考示例主题：尺寸
基础与操作
9 个现有示例SplitButton 分裂按钮
主操作与菜单组合，统一尺寸、变体和禁用。
本库示例主题：尺寸、变体与外观、禁用与只读、加载与异步、受控值、定制与组合
相似功能点逐项对照（7 项）
异步操作与失败恢复 已有示例
对照其他组件库的示例 2 套参考
布局与容器
8 个现有示例Space 间距
横纵间距、换行、对齐与动态内容。
本库示例主题：尺寸、布局与响应式
相似功能点逐项对照（4 项）
响应式布局与换行 已有示例
对照其他组件库的示例 7 套参考
Element Plus ↗Vue 桌面 · 同类组件 · 10 份示例源码
参考示例主题：尺寸、布局与响应式、定制与组合
Naive UI ↗Vue 桌面 · 同类组件 · 17 份示例源码
Vuetify ↗Vue 多端 · 同类组件 · 16 份示例源码
参考示例主题：布局与响应式
Chakra UI ↗React 组合参考 · 同类组件 · 17 份示例源码
参考示例主题：布局与响应式、定制与组合
布局与容器
8 个现有示例Divider 分割线
文字分隔、线型、缩进与方向。
本库示例主题：尺寸、定制与组合
对照其他组件库的示例 6 套参考
Element Plus ↗Vue 桌面 · 同类组件 · 4 份示例源码
参考示例主题：定制与组合
Naive UI ↗Vue 桌面 · 同类组件 · 3 份示例源码
Arco Design Vue ↗Vue 桌面 · 同类组件 · 3 份示例源码
Quasar ↗Vue 多端 · 同类组件 · 4 份示例源码
PrimeNG ↗Angular 交互参考 · 同类组件 · 7 份示例源码
布局与容器
4 个现有示例Grid 栅格
同组子组件 / 接口：GridItem
响应式列数、跨列、折叠与后缀插槽。
本库示例主题：布局与响应式、定制与组合、拖动与排序
相似功能点逐项对照（6 项）
禁用与只读 待核验增量
响应式布局与换行 已有示例
对齐、间距与嵌套 已有示例
对照其他组件库的示例 6 套参考
Vuetify ↗Vue 多端 · 同类组件 · 21 份示例源码
参考示例主题：尺寸、布局与响应式
Chakra UI ↗React 组合参考 · 同类组件 · 4 份示例源码
布局与容器
6 个现有示例Row 行
24 栏布局、双向间距与嵌套隔离。
本库示例主题：布局与响应式
相似功能点逐项对照（5 项）
禁用与只读 待核验增量
插槽与自定义内容 待核验增量
响应式布局与换行 已有示例
对照其他组件库的示例 6 套参考
Vuetify ↗Vue 多端 · 相关组合 · 21 份示例源码
参考示例主题：尺寸、布局与响应式
Chakra UI ↗React 组合参考 · 相关组合 · 4 份示例源码
布局与容器
4 个现有示例Col 列
列宽偏移、排序、弹性比例与响应式隐藏。
本库示例主题：布局与响应式、拖动与排序
相似功能点逐项对照（5 项）
禁用与只读 待核验增量
插槽与自定义内容 待核验增量
响应式布局与换行 已有示例
对照其他组件库的示例 6 套参考
Vuetify ↗Vue 多端 · 相关组合 · 21 份示例源码
参考示例主题：尺寸、布局与响应式
Chakra UI ↗React 组合参考 · 相关组合 · 4 份示例源码
布局与容器
5 个现有示例Layout 布局
同组子组件 / 接口：LayoutContent、LayoutFooter、LayoutHeader、LayoutSider
可伸缩侧栏、折叠方式、固定头尾与独立滚动。
本库示例主题：尺寸、布局与响应式、拖动与排序
相似功能点逐项对照（7 项）
尺寸与密度 待核验增量
插槽与自定义内容 待核验增量
响应式布局与换行 待核验增量
对齐、间距与嵌套 待核验增量
对照其他组件库的示例 7 套参考
Vuetify ↗Vue 多端 · 同类组件 · 7 份示例源码
参考示例主题：布局与响应式
MUI ↗React 设计参考 · 同类组件 · 4 份示例源码
Chakra UI ↗React 组合参考 · 同类组件 · 3 份示例源码
参考示例主题：尺寸
布局与容器
2 个现有示例Paper 基础表面
以表面、圆角与阴影组合容器外观。
相似功能点逐项对照（4 项）
尺寸与密度 待核验增量
变体与视觉层次 待核验增量
插槽与自定义内容 待核验增量
对齐、间距与嵌套 待核验增量
对照其他组件库的示例 9 套参考
Element Plus ↗Vue 桌面 · 相关组合 · 4 份示例源码
Arco Design Vue ↗Vue 桌面 · 相关组合 · 9 份示例源码
Quasar ↗Vue 多端 · 相关组合 · 12 份示例源码
shadcn-vue ↗Vue 组合式 · 相关组合 · 11 份示例源码
PrimeNG ↗Angular 交互参考 · 相关组合 · 4 份示例源码
Chakra UI ↗React 组合参考 · 相关组合 · 10 份示例源码
参考示例主题：尺寸、变体与外观
功能点与增量
展开“相似功能点逐项对照”，可查看已有示例、文档依据和待核验增量；“值得补充的重要内容”按当前分类列出优先级、参考案例和验收重点。待核验表示尚未找到对应专题示例，不直接等同于缺少能力。
示例阅读顺序
基础用法 → 尺寸、变体与状态 → 常用交互 → 异步数据 → 插槽与业务组合 → 边界和生命周期。表单字段与独立面板分别归类，避免将两种接入方式混为同一功能。
怎么判断优势
对相同数据、容器和操作步骤，比较接入配置、额外业务代码及操作结果。当前索引提供源码与示例内容对照；性能、兼容性和失败恢复等结论需要同环境运行验证。