异步组件

概览

以下是对变化的总体概述:

新的 defineAsyncComponent 助手方法, 用于显式地定义异步组件
component 选项被重命名为 loader
Loader 函数本身不再接收 resolve 和 reject 参数, 且必须返回一个 Promise

介绍

以前, 异步组件是通过将组件定义为返回 Promise 的函数来创建的, 例如:

const asyncModal = () => import('./Modal.vue')

或者, 对于带有选项的更高阶的组件语法:

const asyncModal = {
  component: () => import('./Modal.vue'),
  delay: 200,
  timeout: 3000,
  error: ErrorComponent,
  loading: LoadingComponent,
}

3.x 语法

现在, 在 Vue 3 中, 由于函数式组件被定义为纯函数, 因此异步组件需要通过将其包裹在新的 defineAsyncComponent 助手方法中来显式地定义:

import { defineAsyncComponent } from 'vue'
import ErrorComponent from './components/ErrorComponent.vue'
import LoadingComponent from './components/LoadingComponent.vue'

// 不带选项的异步组件
const asyncModal = defineAsyncComponent(() => import('./Modal.vue'))

// 带选项的异步组件
const asyncModalWithOptions = defineAsyncComponent({
  loader: () => import('./Modal.vue'),
  delay: 200,
  timeout: 3000,
  errorComponent: ErrorComponent,
  loadingComponent: LoadingComponent,
})

注意

Vue Router 支持一个类似的机制来异步加载路由组件, 也就是俗称的懒加载。尽管类似, 但是这个功能和 Vue 所支持的异步组件是不同的。当用 Vue Router 配置路由组件时, 不应该使用 defineAsyncComponent。可以在 Vue Router 文档的懒加载路由章节阅读更多相关内容。

对 2.x 所做的另一个更改是, component 选项现在被重命名为 loader, 以明确组件定义不能直接被提供。

import { defineAsyncComponent } from 'vue'

const asyncModalWithOptions = defineAsyncComponent({
  loader: () => import('./Modal.vue'),
  delay: 200,
  timeout: 3000,
  errorComponent: ErrorComponent,
  loadingComponent: LoadingComponent,
})

此外, 与 2.x 不同, loader 函数不再接收 resolve 和 reject 参数, 且必须始终返回 Promise。

// 2.x 版本
const oldAsyncComponent = (resolve, reject) => {
  /* ... */
}

// 3.x 版本
const asyncComponent = defineAsyncComponent(
  () =>
    new Promise((resolve, reject) => {
      /* ... */
    })
)

异步组件 #

概览 #

介绍 #

3.x 语法 #

异步组件

概览

介绍

3.x 语法