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

直接用 v-scope 就能实现局部增强,不需要改整个页面结构,也不用等构建工具——它只接管你明确标记的那块 DOM。
为什么必须用 v-scope 而不是全局挂载
Petite Vue 的设计目标就是“不打扰现有 HTML”,v-scope 是唯一触发响应式接管的入口。没它,哪怕你引入了脚本,所有 {{ }} 和 @click 都只是纯文本。
-
v-scope必须写在要控制的最外层元素上,比如<div v-scope="{ count: 0 }">,子元素自动继承作用域<li>多个 <code>v-scope可共存,彼此隔离:一个计数器和一个待办列表可以互不干扰 - 不能写在
或上——Petite Vue 明确禁止根级挂载,否则会报错"Cannot mount on root element" - 如果用了
init属性(如<script defer init></script>),它只会扫描并初始化带v-scope的节点,不会递归处理整个文档 - 基础写法:
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 - 脚本没加
defer,又放在里:HTML 还没解析完,v-scope元素不存在,初始化失败 - 手动调用
PetiteVue.createApp().mount()但没传选择器:默认尝试挂载document.body,触发上面提到的根元素禁止错误 - 在
v-scope外写事件处理器,比如<button></button>放在v-scope父容器之外——这个count根本不在作用域内 - 用了
v-for但没给每个项提供唯一key:虽然 Petite Vue 不强制要求,但缺key会导致复用逻辑错乱,比如 checkbox 状态粘连 - 把状态抽到 JS 中:
const store = reactive({ count: 0 }),再通过createApp({ store }).mount('#counter') - 配合
eventBus实现两个v-scope区域通信,比如一个表单提交后刷新另一个列表 - 服务端渲染(SSR)页面中,后端可输出初始数据到
window.INITIAL_DATA,JS 里读取后传给createApp(),避免闪屏 - 注意:此时不能再混用内联
v-scope,否则会创建两个独立应用实例,状态不共享
v-scope 的值怎么写才安全
它的值是一个内联 JavaScript 对象字面量,不是 JSON,所以支持函数、getter、甚至注释(但不推荐)。
常见错误:DOM 渲染了但交互没反应
这不是语法问题,而是执行时机或作用域泄露导致的典型现象。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
进阶:用 createApp() 替代内联 v-scope 的适用场景
当数据逻辑变重、需要复用或跨组件通信时,硬编码在 HTML 里就难维护了。
真正容易被忽略的是作用域边界——v-scope 不是 CSS 选择器,它不会穿透 shadow DOM,也不识别动态插入的 HTML(比如 innerHTML 注入的内容),那些得靠手动 createApp().mount() 补救。


















