用途:这是一个 UI 粒子索引,粒子指构建在 coss 原语之上的可复制粘贴 UI 模式。当需要实现某个界面功能时,用它按组件类型和描述查找现成示例。也可在 https://coss.com/ui/particles 可视化浏览。
主要能力:覆盖 54 种组件类型、共 508 个粒子,包括按钮(40)、输入组(28)、日历(25)、选择(23)、滑块(23)、分组(22)、徽章(20)、组合框(20)、自动完成(16)等。每个粒子都对应一段可获取的源码,覆盖表单、对话框、日期选择、导航、菜单、进度、开关等常见交互。
使用方式:先描述所需 UI(如“带校验的表单”“内嵌表单的对话框”“带图标的标签页”),再在本索引中按组件类型和描述检索匹配粒子,然后获取其 JSON 地址以取得完整源码,最后按需改编。JSON 地址格式为 https://coss.com/ui/r/<particle-name>.json,例如 https://coss.com/ui/r/p-accordion-1.json。粒子源码位于仓库 apps/ui/registry/default/particles/。更新索引可在 coss 仓库根目录运行:node apps/ui/scripts/generate-particle-index.cjs。
适用场景:需要快速组装 React/前端界面、寻找表单与弹窗等交互范例、或作为组件库使用参考时。
限制:资料未说明所依赖的具体框架版本、许可协议、是否收费及支持范围;部分粒子涉及外部服务(如 Google Maps Places API)或特定校验库(zod),使用时需自行确认依赖与可用性。