From f4a04c30a8e368e74648db16fd91babd8a4e530a Mon Sep 17 00:00:00 2001 From: zhuangtongfa Date: Mon, 24 Jul 2017 11:28:40 +0800 Subject: [PATCH 1/3] update lazy-loading Chinese docs --- docs/zh-cn/advanced/lazy-loading.md | 37 ++++++++++++++++------------- 1 file changed, 21 insertions(+), 16 deletions(-) diff --git a/docs/zh-cn/advanced/lazy-loading.md b/docs/zh-cn/advanced/lazy-loading.md index 3d899e84f..ce8a4336d 100644 --- a/docs/zh-cn/advanced/lazy-loading.md +++ b/docs/zh-cn/advanced/lazy-loading.md @@ -4,25 +4,28 @@ 结合 Vue 的 [异步组件](http://vuejs.org/guide/components.html#Async-Components) 和 Webpack 的 [code splitting feature](https://doc.webpack-china.org//guides/code-splitting-async/#require-ensure-/), 轻松实现路由组件的懒加载。 -我们要做的就是把路由对应的组件定义成异步组件： +首先，可以将 async 组件定义为返回一个 Promise 的工厂函数(该函数应该 resolve 组件本身): + + +``` js +const Foo = () => Promise.resolve({ /* component definition */ }) +``` + +第二,在 webpack 2中,我们可以使用[动态 import](https://github.com/tc39/proposal-dynamic-import)语法来定义 code split 点(split point): ``` js -const Foo = resolve => { - // require.ensure 是 Webpack 的特殊语法，用来设置 code-split point - // （代码分块） - require.ensure(['./Foo.vue'], () => { - resolve(require('./Foo.vue')) - }) -} +import('./Foo.vue') // returns a Promise ``` -这里还有另一种代码分块的语法，使用 AMD 风格的 require，于是就更简单了： +>注意:如果您使用的是 babel,你将需要添加[syntax-dynamic-import](http://babeljs.io/docs/plugins/syntax-dynamic-import/)插件,babel 可以正确地解析语法。 + +结合这两者，这就是如何定义一个能够被 webpack自动代码分割的异步组件 ``` js -const Foo = resolve => require(['./Foo.vue'], resolve) +const Foo = () => import('./Foo.vue') ``` -不需要改变任何路由配置，跟之前一样使用 `Foo`： +在路由配置中什么都不需要改变，只需要像往常一样使用 `Foo`: ``` js const router = new VueRouter({ @@ -32,14 +35,16 @@ const router = new VueRouter({ }) ``` + ### 把组件按组分块 -有时候我们想把某个路由下的所有组件都打包在同个异步 chunk 中。只需要 [给 chunk 命名](https://webpack.js.org/guides/code-splitting-require/#chunkname)，提供 `require.ensure` 第三个参数作为 chunk 的名称: +有时候我们想把某个路由下的所有组件都打包在同个异步 chunk 中。只需要使用 [命名 chunk](https://webpack.js.org/guides/code-splitting-require/#chunkname),一个特殊的注释语法来提供chunk name(需要webpack > 2.4) + ``` js -const Foo = r => require.ensure([], () => r(require('./Foo.vue')), 'group-foo') -const Bar = r => require.ensure([], () => r(require('./Bar.vue')), 'group-foo') -const Baz = r => require.ensure([], () => r(require('./Baz.vue')), 'group-foo') +const Foo = () => import(/* webpackChunkName: "group-foo" */ './Foo.vue') +const Bar = () => import(/* webpackChunkName: "group-foo" */ './Bar.vue') +const Baz = () => import(/* webpackChunkName: "group-foo" */ './Baz.vue') ``` -Webpack 将相同 chunk 下的所有异步模块打包到一个异步块里面 —— 这也意味着我们无须明确列出 `require.ensure` 的依赖（传空数组就行）。 +webpack 会将任何一个异步模块与相同的块名称组合到相同的异步块中。 From ec0ca73cb5dae2ef119622f6dcd5a78c6f8430ca Mon Sep 17 00:00:00 2001 From: zhuangtongfa Date: Tue, 25 Jul 2017 20:30:45 +0800 Subject: [PATCH 2/3] improve lazy-loading Chinese docs --- docs/zh-cn/advanced/lazy-loading.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/zh-cn/advanced/lazy-loading.md b/docs/zh-cn/advanced/lazy-loading.md index ce8a4336d..7f167e34a 100644 --- a/docs/zh-cn/advanced/lazy-loading.md +++ b/docs/zh-cn/advanced/lazy-loading.md @@ -2,22 +2,22 @@ 当打包构建应用时，Javascript 包会变得非常大，影响页面加载。如果我们能把不同路由对应的组件分割成不同的代码块，然后当路由被访问的时候才加载对应组件，这样就更加高效了。 -结合 Vue 的 [异步组件](http://vuejs.org/guide/components.html#Async-Components) 和 Webpack 的 [code splitting feature](https://doc.webpack-china.org//guides/code-splitting-async/#require-ensure-/), 轻松实现路由组件的懒加载。 +结合 Vue 的 [异步组件](http://vuejs.org/guide/components.html#Async-Components) 和 Webpack 的 [code splitting feature](https://doc.webpack-china.org/guides/code-splitting-async/#require-ensure-/), 轻松实现路由组件的懒加载。 -首先，可以将 async 组件定义为返回一个 Promise 的工厂函数(该函数应该 resolve 组件本身): +首先，可以将异步组件定义为返回一个 Promise 的工厂函数(该函数应该 resolve 组件本身): ``` js -const Foo = () => Promise.resolve({ /* component definition */ }) +const Foo = () => Promise.resolve({ /* 组件定义对象 */ }) ``` -第二,在 webpack 2中,我们可以使用[动态 import](https://github.com/tc39/proposal-dynamic-import)语法来定义 code split 点(split point): +第二,在 webpack 2中,我们可以使用[动态 import](https://github.com/tc39/proposal-dynamic-import)语法来定义代码分块点(split point): ``` js import('./Foo.vue') // returns a Promise ``` ->注意:如果您使用的是 babel,你将需要添加[syntax-dynamic-import](http://babeljs.io/docs/plugins/syntax-dynamic-import/)插件,babel 可以正确地解析语法。 +>注意:如果您使用的是 babel,你将需要添加[syntax-dynamic-import](http://babeljs.io/docs/plugins/syntax-dynamic-import/)插件,才能使 babel 可以正确地解析语法 结合这两者，这就是如何定义一个能够被 webpack自动代码分割的异步组件 @@ -38,7 +38,7 @@ const router = new VueRouter({ ### 把组件按组分块 -有时候我们想把某个路由下的所有组件都打包在同个异步 chunk 中。只需要使用 [命名 chunk](https://webpack.js.org/guides/code-splitting-require/#chunkname),一个特殊的注释语法来提供chunk name(需要webpack > 2.4) +有时候我们想把某个路由下的所有组件都打包在同个异步块(chunk)中。只需要使用 [命名 chunk](https://webpack.js.org/guides/code-splitting-require/#chunkname),一个特殊的注释语法来提供chunk name(需要webpack > 2.4) ``` js From 5346dbb0e6d2c68bf6f95552322b9d5e17e5a4d5 Mon Sep 17 00:00:00 2001 From: zhuangtongfa Date: Tue, 25 Jul 2017 20:43:57 +0800 Subject: [PATCH 3/3] improve lazy-loading Chinese docs --- docs/zh-cn/advanced/lazy-loading.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh-cn/advanced/lazy-loading.md b/docs/zh-cn/advanced/lazy-loading.md index 7f167e34a..871dac52f 100644 --- a/docs/zh-cn/advanced/lazy-loading.md +++ b/docs/zh-cn/advanced/lazy-loading.md @@ -4,7 +4,7 @@ 结合 Vue 的 [异步组件](http://vuejs.org/guide/components.html#Async-Components) 和 Webpack 的 [code splitting feature](https://doc.webpack-china.org/guides/code-splitting-async/#require-ensure-/), 轻松实现路由组件的懒加载。 -首先，可以将异步组件定义为返回一个 Promise 的工厂函数(该函数应该 resolve 组件本身): +首先，可以将异步组件定义为返回一个 Promise 的工厂函数(该函数返回的Promise应该 resolve 组件本身): ``` js