Skip to content

创建应用

创建应用实例

使用 createApp() 创建新的应用实例,每个 Vue 应用都从这里开始:

ts
import { createApp } from 'vue'
const app = createApp({ /* 根组件选项 */ })

根组件

我们传入 createApp 的对象实际上是一个组件,每个应用都需要一个“根组件”,其他组件将作为其子组件。

ts
import { createApp } from 'vue'
// 从一个单文件组件中导入根组件
import App from './App.vue'

const app = createApp(App)

应用配置

应用实例会暴露一个 .config 对象允许我们配置一些应用级的选项,例如定义一个应用级的错误处理器,用来捕获所有子组件上的错误:

ts
app.config.errorHandler = (err) => {
  /* 处理错误 */
}

应用实例还提供了一些方法来注册应用范围内可用的资源,例如注册一个组件:

ts
app.component('TodoDeleteButton', TodoDeleteButton)

挂载应用

应用实例必须在调用了 .mount() 方法后才会渲染出来。该方法接收一个“容器”参数,可以是一个实际的 DOM 元素或是一个 CSS 选择器字符串:

ts
app.mount('#app')
  • 应用根组件的内容将会被渲染在容器元素里面。

  • 容器元素自己将不会被视为应用的一部分。

  • .mount() 方法应该始终在整个应用配置和资源注册完成后被调用

注意

不同于其他资源注册方法,它的返回值是根组件实例而非应用实例。

多个应用实例

同一页可以创建多个 Vue 应用:

ts
const app1 = createApp({
  /* ... */
})
app1.mount('#container-1')

const app2 = createApp({
  /* ... */
})
app2.mount('#container-2')

它们彼此独立,拥有独立的配置与作用域。

如果你正在使用 Vue 来增强服务端渲染 HTML,并且只想要 Vue 去控制一个大型页面中特殊的一小部分,应避免将一个单独的 Vue 应用实例挂载到整个页面上,而是应该创建多个小的应用实例,将它们分别挂载到所需的元素上去。