SuperAPI AI 工具集

f0-component-patterns

前端与建站

查看项目

更新于 10-15 21:40

技能介绍

用途:这是 F0 React 组件库的深度参考技能,补充 packages/react/AGENTS.md 的简明规则,提供构建组件时的详细“怎么做”。适用场景包括从零新建 F0 组件、修改现有组件架构、实现上下文与状态管理、用 CVA、Tailwind 或 Framer Motion 添加样式、为组件添加 i18n 支持。

主要能力与参考文件:组件架构(privateProps、forwardRef、withSkeleton、withDataTestId、index 导出、@/ui/ 层)见 references/component-architecture.md;上下文初始化、受控/非受控、异步 onClick、事件命名见 references/context-and-state.md;CVA、cn()、focusRing()、容器查询、Framer Motion、设计令牌见 references/styling-and-animation.md;i18n 的 useI18n、defaultTranslations、TranslationsType、复数、插值见 references/i18n-patterns.md;单元测试(zeroRender、vi.hoisted()、假定时器、延迟 Promise)需加载 f0-unit-testing 技能。

关键规则:先查 packages/react/AGENTS.md;不要直接导入 Radix,改用 @/ui/ 包装;不要使用 any,需找到正确类型;新组件必须以 F0 前缀开头;测试使用别名为 render 的 zeroRender,而非 @testing-library/react 的 render;所有公开导出的组件必须暴露 dataTestId 属性,可通过 withDataTestId HOC 或内联 DataTestIdWrapper + WithDataTestIdProps 模式实现,判断标准是导出组件是否在 props 中接受 dataTestId。

限制:资料未提供安装命令、版本、收费与平台信息。