一文搞懂Vue3中的異步組件defineAsyncComponentAPI的用法
前言
當(dāng)我們的項(xiàng)目達(dá)到一定的規(guī)模時(shí),對(duì)于某些組件來說,我們并不希望一開始全部加載,而是需要的時(shí)候進(jìn)行加載;這樣的做得目的可以很好的提高用戶體驗(yàn)。
為了實(shí)現(xiàn)這個(gè)功能,Vue3中為我們提供了一個(gè)方法,即defineAsyncComponent,這個(gè)方法可以傳遞兩種類型的參數(shù),分別是函數(shù)類型和對(duì)象類型,接下來我們分別學(xué)習(xí)。
傳遞工廠函數(shù)作為參數(shù)
defineAsyncComponent方法接收一個(gè)工廠函數(shù)是它的基本用法,這個(gè)工廠函數(shù)必須返回一個(gè)Promise,Promise的resolve應(yīng)該返回一個(gè)組件。
我們這里以Vue Cli創(chuàng)建的項(xiàng)目為例,這里我稍微做了一下修改,將頭部的圖片拆分為一個(gè)組件,代碼如下:
<template> <logo-img /> <hello-world msg="Welcome to Your Vue.js App" /> </template> <script setup> import LogoImg from './components/LogoImg.vue' import HelloWorld from './components/HelloWorld.vue' </script>
現(xiàn)在我們就將<hello-world>組件修改為異步組件,示例代碼如下:
<template>
<logo-img />
<hello-world msg="Welcome to Your Vue.js App" />
</template>
<script setup>
import { defineAsyncComponent } from 'vue'
import LogoImg from './components/LogoImg.vue'
// 簡(jiǎn)單用法
const HelloWorld = defineAsyncComponent(() =>
import('./components/HelloWorld.vue'),
)
</script>我們這里為了看到效果,將import延遲執(zhí)行,示例代碼如下:
<script setup>
import { defineAsyncComponent } from 'vue'
import LogoImg from './components/LogoImg.vue'
// 定義一個(gè)耗時(shí)執(zhí)行的函數(shù),t 表示延遲的時(shí)間, callback 表示需要執(zhí)行的函數(shù),可選
const time = (t, callback = () => {}) => {
return new Promise(resolve => {
setTimeout(() => {
callback()
resolve()
}, t)
})
}
// 定義異步組件,這里這樣寫是為了查看效果
const HelloWorld = defineAsyncComponent(() => {
return new Promise((resolve, reject) => {
;(async function () {
try {
await time(2000)
const res = await import('./components/HelloWorld.vue')
resolve(res)
} catch (error) {
reject(error)
}
})()
})
})
</script>代碼運(yùn)行結(jié)果如下所示:

當(dāng)2s后才會(huì)加載<hello-world>組件。
傳遞對(duì)象類型作為參數(shù)
defineAsyncComponent方法也可以接收一個(gè)對(duì)象作為參數(shù),該對(duì)象中有如下幾個(gè)參數(shù):
loader:同工廠函數(shù);loadingComponent:加載異步組件時(shí)展示的組件;errorComponent:加載組件失敗時(shí)展示的組件;delay:顯示loadingComponent之前的延遲時(shí)間,單位毫秒,默認(rèn)200毫秒;timeout:如果提供了timeout,并且加載組件的時(shí)間超過了設(shè)定值,將顯示錯(cuò)誤組件,默認(rèn)值為Infinity(單位毫秒);suspensible:異步組件可以退出<Suspense>控制,并始終控制自己的加載狀態(tài)。onError:一個(gè)函數(shù),該函數(shù)包含4個(gè)參數(shù),分別是error、retry、fail和attempts,這4個(gè)參數(shù)分別是錯(cuò)誤對(duì)象、重新加載的函數(shù)、加載程序結(jié)束的函數(shù)、已經(jīng)重試的次數(shù)。
如下代碼展示defineAsyncComponent方法的對(duì)象類型參數(shù)的用法:
<template>
<logo-img />
<hello-world msg="Welcome to Your Vue.js App" />
</template>
<script setup>
import { defineAsyncComponent } from 'vue'
import LogoImg from './components/LogoImg.vue'
import LoadingComponent from './components/loading.vue'
import ErrorComponent from './components/error.vue'
// 定義一個(gè)耗時(shí)執(zhí)行的函數(shù),t 表示延遲的時(shí)間, callback 表示需要執(zhí)行的函數(shù),可選
const time = (t, callback = () => {}) => {
return new Promise(resolve => {
setTimeout(() => {
callback()
resolve()
}, t)
})
}
// 記錄加載次數(shù)
let count = 0
const HelloWorld = defineAsyncComponent({
// 工廠函數(shù)
loader: () => {
return new Promise((resolve, reject) => {
;(async function () {
await time(300)
const res = await import('./components/HelloWorld.vue')
if (++count < 3) {
// 前兩次加載手動(dòng)設(shè)置加載失敗
reject(res)
} else {
// 大于3次成功
resolve(res)
}
})()
})
},
loadingComponent: LoadingComponent,
errorComponent: ErrorComponent,
delay: 0,
timeout: 1000,
suspensible: false,
onError(error, retry, fail, attempts) {
// 注意,retry/fail 就像 promise 的 resolve/reject 一樣:
// 必須調(diào)用其中一個(gè)才能繼續(xù)錯(cuò)誤處理。
if (attempts < 3) {
// 請(qǐng)求發(fā)生錯(cuò)誤時(shí)重試,最多可嘗試 3 次
console.log(attempts)
retry()
} else {
fail()
}
},
})
</script>上面的代碼中,我們加載組件時(shí)前兩次會(huì)請(qǐng)求錯(cuò)誤,只有第三次加載才會(huì)成功,代碼運(yùn)行結(jié)果如下:

如果加載失敗則會(huì)展示ErrorComponent組件。
總結(jié)
到此這篇關(guān)于一文搞懂Vue3中的異步組件defineAsyncComponentAPI的用法的文章就介紹到這了,更多相關(guān)Vue3異步組件內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
element表格行列的動(dòng)態(tài)合并示例詳解
這篇文章主要為大家介紹了element表格行列的動(dòng)態(tài)合并示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-07-07
vue側(cè)邊欄動(dòng)態(tài)生成下級(jí)菜單的方法
今天小編就為大家分享一篇vue側(cè)邊欄動(dòng)態(tài)生成下級(jí)菜單的方法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2018-09-09
vue+vuex+json-seiver實(shí)現(xiàn)數(shù)據(jù)展示+分頁功能
這篇文章主要介紹了vue+vuex+json-seiver實(shí)現(xiàn)數(shù)據(jù)展示+分頁功能,非常不錯(cuò),具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2019-04-04
Vue 中 createElement 使用實(shí)例詳解
Vue 提供了createElement 來創(chuàng)建虛擬dom,方便我們來函數(shù)化的方式來定義復(fù)雜的組件結(jié)構(gòu),這篇文章主要介紹了Vue 中 createElement 使用詳解,需要的朋友可以參考下2022-10-10
vue父組件向子組件動(dòng)態(tài)傳值的兩種方法
這篇文章主要介紹了vue父組件向子組件動(dòng)態(tài)傳值的兩種方法 ,需要的朋友可以參考下2017-11-11
vue+bpmn.js實(shí)現(xiàn)自定義流程圖的完整代碼
這篇文章主要介紹了vue+bpmn.js實(shí)現(xiàn)自定義流程圖的完整代碼,本文通過實(shí)例代碼給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借價(jià)值,需要的朋友參考下吧2024-03-03
Vue實(shí)現(xiàn)Tab選項(xiàng)卡切換
這篇文章主要為大家詳細(xì)介紹了Vue實(shí)現(xiàn)Tab選項(xiàng)卡切換,點(diǎn)擊不同標(biāo)題顯示對(duì)應(yīng)圖片,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2021-09-09
vue 彈窗時(shí) 監(jiān)聽手機(jī)返回鍵關(guān)閉彈窗功能(頁面不跳轉(zhuǎn))
這篇文章主要介紹了vue 彈窗時(shí) 監(jiān)聽手機(jī)返回鍵關(guān)閉彈窗功能,本文給大家介紹的非常詳細(xì),具有一定的參考借鑒價(jià)值(頁面不跳轉(zhuǎn)) ,需要的朋友可以參考下2019-05-05

