异步组件

Watch a free video lesson on Vue School

在大型应用中，我们可能需要将应用分割成小一些的代码块，并且只在需要的时候才从服务器加载一个模块。为了简化，Vue 允许你以一个工厂函数的方式定义你的组件，这个工厂函数会异步解析你的组件定义。Vue 只有在这个组件需要被渲染的时候才会触发该工厂函数，且会把结果缓存起来供未来重渲染。例如：

  1. Vue.component('async-example', function (resolve, reject) {
  2.   setTimeout(function () {
  3.     // 向 `resolve` 回调传递组件定义
  4.     resolve({
  5.       template: '<div>I am async!</div>'
  6.     })
  7.   }, 1000)
  8. })

如你所见，这个工厂函数会收到一个 resolve 回调，这个回调函数会在你从服务器得到组件定义的时候被调用。你也可以调用 reject(reason) 来表示加载失败。这里的 setTimeout 是为了演示用的，如何获取组件取决于你自己。一个推荐的做法是将异步组件和 webpack 的 code-splitting 功能一起配合使用：

  1. Vue.component('async-webpack-example', function (resolve) {
  2.   // 这个特殊的 `require` 语法将会告诉 webpack
  3.   // 自动将你的构建代码切割成多个包，这些包
  4.   // 会通过 Ajax 请求加载
  5.   require(['./my-async-component'], resolve)
  6. })

你也可以在工厂函数中返回一个 Promise，所以把 webpack 2 和 ES2015 语法加在一起，我们可以写成这样：

  1. Vue.component(
  2.   'async-webpack-example',
  3.   // 这个 `import` 函数会返回一个 `Promise` 对象。
  4.   () => import('./my-async-component')
  5. )

当使用局部注册的时候，你也可以直接提供一个返回 Promise 的函数：

  1. new Vue({
  2.   // ...
  3.   components: {
  4.     'my-component': () => import('./my-async-component')
  5.   }
  6. })

如果你是一个 Browserify 用户同时喜欢使用异步组件，很不幸这个工具的作者明确表示异步加载“并不会被 Browserify 支持”，至少官方不会。Browserify 社区已经找到了一些变通方案，这些方案可能会对已存在的复杂应用有帮助。对于其它的场景，我们推荐直接使用 webpack，以拥有内置的头等异步支持。

处理加载状态

2.3.0+ 新增

这里的异步组件工厂函数也可以返回一个如下格式的对象：

  1. const AsyncComponent = () => ({
  2.   // 需要加载的组件 (应该是一个 `Promise` 对象)
  3.   component: import('./MyComponent.vue'),
  4.   // 异步组件加载时使用的组件
  5.   loading: LoadingComponent,
  6.   // 加载失败时使用的组件
  7.   error: ErrorComponent,
  8.   // 展示加载时组件的延时时间。默认值是 200 (毫秒)
  9.   delay: 200,
  10.   // 如果提供了超时时间且组件加载也超时了，
  11.   // 则使用加载失败时使用的组件。默认值是：`Infinity`
  12.   timeout: 3000
  13. })

注意如果你希望在 Vue Router 的路由组件中使用上述语法的话，你必须使用 Vue Router 2.4.0+ 版本。