Skip to content

Commit

Permalink
docs: translate /guide/components/async
Browse files Browse the repository at this point in the history
  • Loading branch information
xiaodong2008 committed Apr 24, 2024
1 parent 473e4de commit 1d6e34d
Showing 1 changed file with 22 additions and 22 deletions.
44 changes: 22 additions & 22 deletions src/guide/components/async.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
# 异步组件 {#async-components}
# 異步組件 {#async-components}

## 基本用法 {#basic-usage}

在大型项目中,我们可能需要拆分应用为更小的块,并仅在需要时再从服务器加载相关组件。Vue 提供了 [`defineAsyncComponent`](/api/general#defineasynccomponent) 方法来实现此功能
在大型項目中,我們可能需要拆分應用為更小的模塊,並僅在需要時再從服務器加載相關組件。Vue 提供了 [`defineAsyncComponent`](/api/general#defineasynccomponent) 方法來實現此功能

```js
import { defineAsyncComponent } from 'vue'

const AsyncComp = defineAsyncComponent(() => {
return new Promise((resolve, reject) => {
// ...从服务器获取组件
resolve(/* 获取到的组件 */)
// ...從服務器獲取組件
resolve(/* 獲取到的組件 */)
})
})
// ... 像使用其他一般组件一样使用 `AsyncComp`
// ... 像使用其他一般組件一樣使用 `AsyncComp`
```

如你所见`defineAsyncComponent` 方法接收一个返回 Promise 的加载函数。这个 Promise 的 `resolve` 回调方法应该在从服务器获得组件定义时调用。你也可以调用 `reject(reason)` 表明加载失败
如你所見`defineAsyncComponent` 方法接收一個返回 Promise 的加載函數。這個 Promise 的 `resolve` 回調方法應該在從服務器獲得組件定義時調用。你也可以調用 `reject(reason)` 表明加載失敗

[ES 模块动态导入](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import)也会返回一个 Promise,所以多数情况下我们会将它和 `defineAsyncComponent` 搭配使用。类似 Vite 和 Webpack 这样的构建工具也支持此语法 (并且会将它们作为打包时的代码分割点),因此我们也可以用它来导入 Vue 单文件组件
[ES 模塊動態導入](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import)也會返回一個 Promise,所以多數情況下我們會將它和 `defineAsyncComponent` 搭配使用。類似 Vite 和 Webpack 這樣的構建工具也支持此語法 (並且會將它們作為打包時的代碼分割點),因此我們也可以用它來導入 Vue 單文件組件

```js
import { defineAsyncComponent } from 'vue'
Expand All @@ -28,9 +28,9 @@ const AsyncComp = defineAsyncComponent(() =>
)
```

最后得到的 `AsyncComp` 是一个外层包装过的组件,仅在页面需要它渲染时才会调用加载内部实际组件的函数。它会将接收到的 props 和插槽传给内部组件,所以你可以使用这个异步的包装组件无缝地替换原始组件,同时实现延迟加载
最後得到的 `AsyncComp` 是一個外層封裝過的組件,只在頁面需要它渲染時才會調用加載內部實際組件的函數。它會將接收到的 props 和插槽傳給內部組件,所以你可以使用這個異步的包裝組件無縫地替換原始組件,同時實現延遲加載

与普通组件一样,异步组件可以使用 `app.component()` [全局注册](/guide/components/registration#global-registration)
與普通組件一樣,異步組件可以使用 `app.component()` [全局註冊](/guide/components/registration#global-registration)

```js
app.component('MyComponent', defineAsyncComponent(() =>
Expand All @@ -40,7 +40,7 @@ app.component('MyComponent', defineAsyncComponent(() =>

<div class="options-api">

你也可以在[局部注册组件](/guide/components/registration#local-registration)时使用 `defineAsyncComponent`
你也可以在[局部註冊組件](/guide/components/registration#local-registration)時使用 `defineAsyncComponent`

```vue
<script>
Expand All @@ -64,7 +64,7 @@ export default {

<div class="composition-api">

也可以直接在父组件中直接定义它们
也可以直接在父組件中直接定義它們

```vue
<script setup>
Expand All @@ -82,32 +82,32 @@ const AdminPage = defineAsyncComponent(() =>

</div>

## 加载与错误状态 {#loading-and-error-states}
## 加載與錯誤狀態 {#loading-and-error-states}

异步操作不可避免地会涉及到加载和错误状态,因此 `defineAsyncComponent()` 也支持在高级选项中处理这些状态
異步操作不可避免地會涉及到加載和錯誤狀態,因此 `defineAsyncComponent()` 也支持在高級選項中處理這些狀態

```js
const AsyncComp = defineAsyncComponent({
// 加载函数
// 加載函數
loader: () => import('./Foo.vue'),

// 加载异步组件时使用的组件
// 加載異步組件時使用的組件
loadingComponent: LoadingComponent,
// 展示加载组件前的延迟时间,默认为 200ms
// 展示加載組件前的延遲時間,默認為 200ms
delay: 200,

// 加载失败后展示的组件
// 加載失敗後展示的組件
errorComponent: ErrorComponent,
// 如果提供了一个 timeout 时间限制,并超时了
// 也会显示这里配置的报错组件,默认值是:Infinity
// 如果提供了一個 timeout 時間限制,並超時了
// 也會顯示這裡配置的報錯組件,默認值是:Infinity
timeout: 3000
})
```

如果提供了一个加载组件,它将在内部组件加载时先行显示。在加载组件显示之前有一个默认的 200ms 延迟——这是因为在网络状况较好时,加载完成得很快,加载组件和最终组件之间的替换太快可能产生闪烁,反而影响用户感受
如果提供了一個加載組件,它將在內部組件加載時先行顯示。在加載組件顯示之前有一個默認的 200ms 延遲——這是因為在網絡狀況較好時,加載完成得很快,加載組件和最終組件之間的替換太快可能產生閃爍,反而影響用戶感受

如果提供了一个报错组件,则它会在加载器函数返回的 Promise 抛错时被渲染。你还可以指定一个超时时间,在请求耗时超过指定时间时也会渲染报错组件
如果提供了一個報錯組件,則它會在加載器函數返回的 Promise 拋錯時被渲染。你還可以指定一個超時時間,在請求耗時超過指定時間時也會渲染報錯組件

## 搭配 Suspense 使用 {#using-with-suspense}

异步组件可以搭配内置的 `<Suspense>` 组件一起使用,若想了解 `<Suspense>` 和异步组件之间交互,请参阅 [`<Suspense>`](/guide/built-ins/suspense) 章节
異步組件可以搭配內置的 `<Suspense>` 組件一起使用,若想了解 `<Suspense>` 和異步組件之間交互,請參閱 [`<Suspense>`](/guide/built-ins/suspense) 章節

0 comments on commit 1d6e34d

Please sign in to comment.