SuperAPI AI 工具集

vue

前端与建站

查看项目

更新于 10-16 10:47

技能介绍

用途 本规则面向使用 Vue.js 并以 Composition API 方式构建应用的场景,核心目标是统一代码风格与状态管理方式,主要结合 TypeScript 使用。触发条件为:使用 Composition API 构建 Vue.js 应用时。

主要能力与约定

  1. Script Setup(必需):始终使用带 TypeScript 的 script setup,示例中包含 defineProps、defineEmits 的泛型用法,以及 ref 与 computed 的基本写法。
  2. Composables(必需):将可复用逻辑抽取为 composables。示例给出 useUser.ts,接收 Ref<string> 类型的 userId,内部用 ref 保存 user 与 loading,并通过 watchEffect 异步获取数据后返回 { user, loading }。
  3. 响应式状态(必需):基本类型使用 ref;对象使用 reactive;派生值使用 computed。示例中 activeUsers 通过 computed 过滤 state.users 得到活跃用户。

决策树 需要基本类型状态 → 使用 ref();需要对象状态 → 使用 reactive();需要派生值 → 使用 computed();需要副作用 → 使用 watchEffect();需要特定监听 → 使用 watch();需要可复用逻辑 → 创建 composable。

代码示例 组件中的 v-model:使用 defineModel<string>(),模板中以 :value 绑定并以 @input 更新。 异步组件:使用 defineAsyncComponent(() => import('./components/Modal.vue'))。

命令 npm create vue@latest myapp npm run dev npm run build npm run test:unit

适用场景 适用于以 Vue 3 Composition API 与 TypeScript 构建前端应用、需要统一 script setup、composables 与响应式状态约定的开发团队或个人。

限制 以上内容为规则定义与示例,关于具体版本兼容性、团队协作流程、测试覆盖要求、性能与效果等细节暂未提供。