Arco Design React 组件参考
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b0e06ef2/arco-design。
技能介绍
为什么需要这份参考
在企业后台里用 Arco Design React(@arco-design/web-react)写页面时,常见翻车点不是「会不会用组件」,而是和 Ant Design 混用习惯:从子路径导入、Form.Item 误用 name、日期库仍写 moment、表单里 Switch 没设 triggerPropName="checked" 导致受控失效。这些细节官方文档分散在长页里,模型若只靠泛化训练很容易生成不符合库约定的代码。
技能如何组织信息
本技能把 Arco 当成可检索的约定 + 组件索引:开头固定 Critical Conventions(根包导入、图标路径、样式入口、dayjs、受控/非受控、子组件 Component.Sub 写法),再按场景拆表——Setup & Configuration(安装、ConfigProvider、主题、国际化、架构)、General / Layout / Navigation、Data Entry、Data Display、Feedback 等,每个组件指向独立 *.md 说明 API 与示例;另有 Patterns & Best Practices(表单、表格、弹窗、响应式)以及少量 Hooks(如 useVerificationCode、useWatermark)。写代码时应先对齐约定,再按任务加载对应条目文件。
适用边界与注意点
技能覆盖的是 React 版 Web 组件库 的使用规范,不包含 Arco Design Vue、移动端或其他非 @arco-design/web-react 产品线。索引以「何时查阅哪份 md」为主,具体 props 以加载后的参考文件为准;需要完全自定义 UI 时再考虑 @arco-design/web-react/hooks,否则优先用现成组件。
使用场景
- 新页面要用 Arco 的 `Form` + `Table` 做筛选列表,需要按 `field`、dayjs 和根路径导入一次性写对
- 从 Ant Design 迁到 Arco,要把 `Form.Item`、受控 Switch、图标与样式引入方式逐条对照改写法
- 后台要配主题、语言包和全局尺寸,需要查 ConfigProvider、theming 与 internationalization 对应条目
- 大列表表格要做远程分页、固定列或虚拟滚动,需要对照 table-patterns 与 table.md 的实现要点
适合人员
- 维护字节系或 Arco 技术栈中后台的前端工程师,需要模型输出符合库约定的 TSX
- 接手中台/运营后台项目的 React 开发者,要在不翻完整官网的前提下对齐组件与表单写法
- 负责设计系统落地的工程师,需要把主题、国际化与表单校验模式写成可复用实现
- 从 Ant Design 切到 Arco 的技术负责人,要减少因 API 差异导致的联调与回归问题