v-scope是Petite Vue实现局部增强的唯一入口,必须写在控制区域最外层元素上,值为内联JS对象字面量,支持函数和响应式属性,多个v-scope彼此隔离且不可挂载于根元素。

直接用 v-scope 就能实现局部增强,不需要改整个页面结构,也不用等构建工具——它只接管你明确标记的那块 DOM。
为什么必须用 v-scope 而不是全局挂载
Petite Vue 的设计目标就是“不打扰现有 HTML”,v-scope 是唯一触发响应式接管的入口。没它,哪怕你引入了脚本,所有 {{ }} 和 @click 都只是纯文本。
-
v-scope必须写在要控制的最外层元素上,比如,子元素自动继承作用域- 多个
v-scope可共存,彼此隔离:一个计数器和一个待办列表可以互不干扰- 不能写在
或上——Petite Vue 明确禁止根级挂载,否则会报错"Cannot mount on root element"- 如果用了
init属性(如<script defer init></script>),它只会扫描并初始化带v-scope的节点,不会递归处理整个文档v-scope的值怎么写才安全它的值是一个内联 JavaScript 对象字面量,不是 JSON,所以支持函数、getter、甚至注释(但不推荐)。
- 基础写法:
v-scope="{ count: 0, name: 'Petite' }"—— 所有属性自动响应式 - 要加方法?直接写:
v-scope="{ count: 0, increment() { this.count++ } }",然后在模板里@click="increment" - 避免写复杂表达式:
v-scope="{ items: window.DATA || [] }"是可行的,但v-scope="{ items: fetch('/api').then(...)}"会立即执行并报错,异步逻辑得放到方法里 - 不要在其中引用未声明变量,比如
v-scope="{ total: price * qty }"会因price未定义而静默失败,控制台可能只显示ReferenceError
常见错误:DOM 渲染了但交互没反应
这不是语法问题,而是执行时机或作用域泄露导致的典型现象。
- 脚本没加
defer,又放在里:HTML 还没解析完,v-scope元素不存在,初始化失败 - 手动调用
PetiteVue.createApp().mount()但没传选择器:默认尝试挂载document.body,触发上面提到的根元素禁止错误 - 在
v-scope外写事件处理器,比如放在v-scope父容器之外——这个count根本不在作用域内 - 用了
v-for但没给每个项提供唯一key:虽然 Petite Vue 不强制要求,但缺key会导致复用逻辑错乱,比如 checkbox 状态粘连
进阶:用
createApp()替代内联v-scope的适用场景当数据逻辑变重、需要复用或跨组件通信时,硬编码在 HTML 里就难维护了。
- 把状态抽到 JS 中:
const store = reactive({ count: 0 }),再通过createApp({ store }).mount('#counter') - 配合
eventBus实现两个v-scope区域通信,比如一个表单提交后刷新另一个列表 - 服务端渲染(SSR)页面中,后端可输出初始数据到
window.INITIAL_DATA,JS 里读取后传给createApp(),避免闪屏 - 注意:此时不能再混用内联
v-scope,否则会创建两个独立应用实例,状态不共享
真正容易被忽略的是作用域边界——
v-scope不是 CSS 选择器,它不会穿透 shadow DOM,也不识别动态插入的 HTML(比如innerHTML注入的内容),那些得靠手动createApp().mount()补救。 - 多个
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











