Vue的异步组件怎么使用

其他教程   发布日期:2025年04月02日   浏览次数:251

这篇文章主要讲解了“Vue的异步组件怎么使用”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“Vue的异步组件怎么使用”吧!

基本用法

在大型项目中,我们可能需要拆分应用为更小的块,并仅在需要时再从服务器加载相关组件。Vue 提供了defineAsyncComponent方法来实现此功能:

  1. import { defineAsyncComponent } from 'vue'
  2. const AsyncComp = defineAsyncComponent(() => {
  3. return new Promise((resolve, reject) => {
  4. // ...从服务器获取组件
  5. resolve(/* 获取到的组件 */)
  6. })
  7. })
  8. // ... 像使用其他一般组件一样使用 `AsyncComp`

如你所见,

  1. defineAsyncComponent
方法接收一个返回 Promise 的加载函数。这个 Promise 的
  1. resolve
回调方法应该在从服务器获得组件定义时调用。你也可以调用
  1. reject(reason)
表明加载失败。

ES 模块动态导入也会返回一个 Promise,所以多数情况下我们会将它和

  1. defineAsyncComponent
搭配使用。类似 Vite 和 Webpack 这样的构建工具也支持此语法 (并且会将它们作为打包时的代码分割点),因此我们也可以用它来导入 Vue 单文件组件:
  1. import { defineAsyncComponent } from 'vue'
  2. const AsyncComp = defineAsyncComponent(() =>
  3. import('./components/MyComponent.vue')
  4. )

最后得到的

  1. AsyncComp
是一个外层包装过的组件,仅在页面需要它渲染时才会调用加载内部实际组件的函数。它会将接收到的 props 和插槽传给内部组件,所以你可以使用这个异步的包装组件无缝地替换原始组件,同时实现延迟加载。

与普通组件一样,异步组件可以使用

  1. app.component()
全局注册:
  1. app.component('MyComponent', defineAsyncComponent(() =>
  2. import('./components/MyComponent.vue')
  3. ))

你也可以在局部注册组件时使用

  1. defineAsyncComponent
  1. <script>
  2. import { defineAsyncComponent } from 'vue'
  3. export default {
  4. components: {
  5. AdminPage: defineAsyncComponent(() =>
  6. import('./components/AdminPageComponent.vue')
  7. )
  8. }
  9. }
  10. </script>
  11. <template>
  12. <AdminPage />
  13. </template>

加载与错误状态

异步操作不可避免地会涉及到加载和错误状态,因此

  1. defineAsyncComponent()
也支持在高级选项中处理这些状态:
  1. const AsyncComp = defineAsyncComponent({
  2. // 加载函数
  3. loader: () => import('./Foo.vue'),
  4. // 加载异步组件时使用的组件
  5. loadingComponent: LoadingComponent,
  6. // 展示加载组件前的延迟时间,默认为 200ms
  7. delay: 200,
  8. // 加载失败后展示的组件
  9. errorComponent: ErrorComponent,
  10. // 如果提供了一个 timeout 时间限制,并超时了
  11. // 也会显示这里配置的报错组件,默认值是:Infinity
  12. timeout: 3000
  13. })

如果提供了一个加载组件,它将在内部组件加载时先行显示。在加载组件显示之前有一个默认的 200ms 延迟&mdash;&mdash;这是因为在网络状况较好时,加载完成得很快,加载组件和最终组件之间的替换太快可能产生闪烁,反而影响用户感受。

如果提供了一个报错组件,则它会在加载器函数返回的 Promise 抛错时被渲染。你还可以指定一个超时时间,在请求耗时超过指定时间时也会渲染报错组件。

搭配 Suspense 使用

异步组件可以搭配内置的

  1. <Suspense>
组件一起使用。

以上就是Vue的异步组件怎么使用的详细内容,更多关于Vue的异步组件怎么使用的资料请关注九品源码其它相关文章!