在 vue 3 中,创建独立响应式实例的模式已从 vue 2 的 new vue() 转向 createapp()。本教程将详细介绍如何使用 createapp() 结合 setup() 函数,在不依赖单文件组件的情况下,为现有 dom 元素添加响应式功能。无论是通过 cdn 引入 vue,还是在基于模块打包器的项目中,都能高效地构建轻量级或多实例的 vue 应用。
在 Vue 2 中,开发者习惯于通过 new Vue({...}) 构造函数直接创建一个 Vue 实例,并将其挂载到指定的 DOM 元素上,从而为该元素及其内部提供响应式数据和方法。这种模式对于快速原型开发或为现有页面添加局部交互功能非常便捷。
Vue 3 引入了 createApp() 函数作为创建应用实例的入口,并推荐使用组合式 API(Composition API)中的 setup() 函数来组织组件逻辑和响应式状态。虽然 Vue 3 的设计更侧重于单文件组件(SFC),但它依然提供了在不定义完整组件的情况下,创建并挂载响应式应用实例的能力,这与 Vue 2 的独立实例模式异曲同工。
当您希望在现有 HTML 页面中快速添加 Vue 3 的响应式功能,而无需复杂的构建流程时,通过 CDN 引入 Vue 是最直接的方式。
这种方式下,Vue 实例会接管指定 DOM 元素内部的模板内容。
HTML 结构: 首先,在您的 HTML 文件中引入 Vue 3 的全局构建版本,并准备一个用于挂载 Vue 应用的 DOM 元素。
Vue 3 CDN 示例
{{ msg }}
说明:
如果您希望将模板内容直接定义在 JavaScript 中,而不是依赖现有的 DOM 结构,可以使用 template 选项。
HTML 结构: 此时,#app 元素只需要作为挂载点,内部无需包含模板内容。
Vue 3 CDN Template 示例
说明:
在现代前端开发中,通常会使用模块打包器(如 Webpack、Vite)来管理项目依赖、编译代码和优化资源。通过这种方式创建的 Vue 3 应用通常是独立文件,并且可以方便地集成到更大型的项目中。
首先,您需要一个基于 Vue 3 的项目。如果您还没有,可以使用 Vite 快速创建一个:
npm create vite@latest my-vue3-app -- --template vue cd my-vue3-app npm install
在您的项目入口文件(通常是 main.js 或 src/main.js)中,您可以
像这样创建并挂载一个独立的 Vue 3 应用实例:
// src/main.js
import { createApp, ref } from 'vue'; // 从 'vue' 模块导入 createApp 和 ref
// 定义一个根组件选项对象
const appOptions = {
setup() {
const msg = ref("Hello from Module!");
return { msg };
},
// 同样可以使用 template 选项定义模板
template: `
{{ msg }}
`
};
// 创建应用实例并挂载
createApp(appOptions).mount('#app');HTML 结构: 在 index.html 中,您只需要一个空的挂载点。
Vue 3 Module 示例
说明:
通过上述方法,您可以在 Vue 3 中灵活地创建独立响应式实例,无论是快速集成到现有页面,还是构建模块化的前端应用,都能够找到适合的实践方案。