--- title: vue-cli + webpack 多页面实例配置方法 date: 2016年8月26日 tags: - vuejs - 多页面 - webpack ---
目前使用vue来做项目,估计大部分都是单页面(SPA)应用,一个轻型的 MVVM 框架,谁用了MVVM框架,就再也回不去JQ时代了,哈哈。
在手机端的项目,使用vue + vue-router是high到爆,不仅仅是我们开发的而言,最主要的用户体检也是开足马力,体检感杠杠的。
那问题来了,使用vue+webpack的单页面是爽到爆,那如果是多页面也能不能high到爆呢?那当然呀,必须的必,vue、webpack的忠粉(哈哈,好像这忠粉不关系到多页面的)。
在谷歌找vue 多页面,实例还是比较少,功夫不负有心人,在yaoyao1987那找到了,具体可以到这个yaoyao1987 github,非常感谢yaoyao1987童鞋,今天要讲的内容是基于yaoyao1987童鞋的多页面实例上再优化的。
1、demo:http://v.lanchenglv.com/demo/vue-cli-multi-page/module/login.html 2、github:https://github.com/bluefox1688/vue-cli-multi-page
我们先来讲讲,具体我们优化了什么内容。
- 增加全局统一使用的模块
Lib.js库,可能这里看不明白,不要紧,后面会讲到。 - 支持字体图标
- 增加干净的页面、组件的模板,复制即可以使用。
- 去掉多余的代码注释,坑了我的注释,别再坑人了
- 构建时,增加对css打包的支持
- 提取公共模块 ........
# 安装 npm install # 调试环境 serve with hot reload at http://localhost:8083/module/login.html npm run dev # 生产环境 build for production with minification npm run build
本地默认访问端口为8083,需要更改的童鞋请到项目根目录文件config.js修改。
webpack
|---build
|---src
|---assets 资源
|---css.css css
|---img 图片文件
|---font/ 字体图标
|---components 组件
|---Button.vue 按钮组件
|---module-head.vue head组件
|---module各个页面模块
|---login 登陆模块
|---login.html
|---login.js
|---app.vue
|---welcome 欢迎页模块
|---welcome.html
|---welcome.js
|---app.vue
从目录结构上,各种组件、页面模块、资源等都按类新建了文件夹,方便我们储存文件。
其实我们所有的文件,最主要都是放在module文件夹里,以文件夹名为html的名称。
例如
|---login 登陆模块 |---login.html |---login.js |---app.vue
就是我们访问时的地址:
http://localhost:8083/module/login.html
这里一定要记住,在module里下级文件夹,一个文件夹就是一个html,js``vue template 都统一放在当前文件夹里,当然你也可以继续放其他的资源,例如css、图片等,webpack会打包到当前页面里。
如果项目不需要这个页面了,可以直接把这个文件夹直接删除掉,干净项目,干活也开心。
像以前我们传统开发项目,所有的图片都习惯放在images里,当项目有改动时,有些图片等资源用不上了,但还占着坑位,虽然现在的硬件容量大到惊人,但我们应该还是要养到一个良好的习惯。
当前页面的开发在app.vue里,打开后你就会看到很熟悉的<template>、<script>、<style scoped>了。
我们做多页面开发,那肯定会涉及到全局都能调用的公共库,或者是把别人封装的库也一起打包在全局公共模块里。
如果看过源码的童鞋,在*.vue页面里,我都统一import了一个文件
import Lib from 'assets/Lib.js'
这就是全局统一公共模块,我们先看看Lib.js里的代码
# 导入全局的css import 'assets/css.css'; # 导入全局的站点配置文件 import C from 'assets/conf'; # 导入全局的共用事件 import M from 'assets/common'; var Rxports = { M,C }; module.exports = Rxports
在上方代码的M、C都是什么鬼,聪明的小伙伴就知道我想干嘛了,省写少事呗。
例如我们现在想调用APP的名称,在.vue里可以这么写
import Lib from 'assets/Lib.js' Lib.C.appname; # 蓝锅锅
只需要在*.vue里导入import Lib from 'assets/Lib.js',就可以到处使用全局模块了。
不再像传统的开发模式,需要一堆的<script>一个一个的来放到页面的底部。
传统方式:
<script type='text/javascript' src='//g.alicdn.com/sj/lib/zepto/zepto.min.js' charset='utf-8'></script> ></script> <script type='text/javascript' src='//g.alicdn.com/msui/sm/0.6.2/js/sm.min.js' charset='utf-8'></script> <script type="text/javascript" src="http://res.wx.qq.com/open/js/jweixin-1.0.0.js"></script>
这里就是我想讲的关于优化的第一点提到的全局模块库。
当然也有童鞋问呀,会不会每个页面都会把这些全局模块库都打包在当前页面,那JS文件体积大到惊人。
哎呀,你当webpack是二货的呀,webpack会自动帮你处理好的,会把在*.vue里的import Lib from 'assets/Lib.js'的库自动提取出来,放到一个全局的JS文件里,这就是自动构造的神奇呀,省心省电,妈妈再也不用担心我做重复的工作了。
在Lib.js里,我们也看到有两个导入的JS文件,主要来做什么的呢?
为了更好的在全局调用模块里,知道哪个模块的作用是什么,另外在写代码时更能快速查找到JS文件,我区分了配置文件和共用事件文件,即conf、common,下面说下具体的用途。
# 储存站点的配置,例如web的名称、LOGO地址等 import C from 'assets/conf'; # 导入全局的共用事件,例如在微信的JS SDK初始化,每个页面都要分享,都需要初始化的,一次调用,全局使用,棒!! import M from 'assets/common';
当然,你也可以不像这样区分不同的JS文件,删除也没有影响的,具体也要看项目的需要而定,不能死读书。
另外,如果想要干净的页面模块模板,可以到根目录的tpl里复制module_tpl整个文件夹,然后粘贴到src/module目录下马上就可以进行开发了,开发之前记得在cmd里npm run dev跑一遍,新增页面都要重新dev一遍。
module我们就讲到这里,下面我们来讲讲组件的调用,最爱组件了。
组件(Component)是 vue.js 最强大的功能之一,当你发现使用组件可以减少造轮子里,你会深深的爱上它。
我们的组件都是放在components目录下的,调用组件的方法也很简单。
import Button from 'components/Button';
然后记得在*.vue注册导入的组件,要不然会影响使用。
import Button from 'components/Button'; export default { data() { return { } }, components: { # 在这里注册组件,不注册组件的话,是无法使用的。 Button } }
如果想要干净的组件模板,可以到根目录的tpl里找到components_tpl的Hello.vue文件,复制粘贴到components目录下马上就可以进行开发了。
在yaoyao1987童鞋里,是没有打包构造图标字体的代码逻辑,这也是我优化上去的一部分,建议使用iconfont图标(http://www.iconfont.cn) ,强大到无所不能,可以到iconfont下载自己想要的图标字体,记得是把文件放到\src\assets\font文件夹里。
webpack会自动打包的,无需理会,另外还有一点,iconfont提供的css文件,复制到\src\assets\css.css文件即可,要不然没有效果哈。
在*.vue里使用调用就行了。
<i class="iconfont">!</i>
那我们使用的是vue-cli的手脚架,用过vue+cli的朋友知道主要构建代码都放在根目录build下,vue多页面主要修改了这三个JS文件webpack.base.conf.js、webpack.dev.conf.js、webpack.prod.conf.js
# 【webpack.base.conf.js】主要是构建的全局设置,主要是增加了以下代码,已经增加在JS文件里,这里只是做一个补充说明,具体请看`build/webpack.base.conf.js`。 var entries = getEntry('./src/module/**/*.js'); // 获得入口js文件 var chunks = Object.keys(entries); plugins: [ // 提取公共模块 new webpack.optimize.CommonsChunkPlugin({ name: 'vendors', // 公共模块的名称 chunks: chunks, // chunks是需要提取的模块 minChunks: chunks.length }), // 配置提取出的样式文件 new ExtractTextPlugin('css/[name].css') ] function getEntry(globPath) { var entries = {}, basename, tmp, pathname; glob.sync(globPath).forEach(function (entry) { basename = path.basename(entry, path.extname(entry)); tmp = entry.split('/').splice(-3); pathname = tmp.splice(0, 1) + '/' + basename; // 正确输出js和html的路径 entries[pathname] = entry; }); return entries; }
这里还要做一个特别说明,我们每次更新资源文件,为了去缓存,都会给文件生成hash值,例如:
<script type='text/javascript' src='vendors.61714a310523a3df9869.js' charset='utf-8'></script> <script type='text/javascript' src='vendors.js?f3aaf25de220e214f84e' charset='utf-8'></script>
这两者都是为了去缓存,唯一的区别的生成的文件名不一样,有些项目,为了可以能出严重BUG时第一时间回滚,以文件名+hash的方式储存,每次生成都不会覆盖之前的代码,以方便查BUG或者回滚。
另一种方式,就是以文件名+?hash的方式储存,每次都会覆盖之前生成的资源,方便在某些特殊项目使用。
我在webpack.base.conf.js也已经注释说明了。
module.exports = { entry: entries, output: { path: config.build.assetsRoot, publicPath: config.build.assetsPublicPath, /* ---- 生成的例子 vendors.61714a310523a3df9869.js --- */ //filename: '[name].[hash].js' /* ---- 生成的例子 vendors.js?f3aaf25de220e214f84e --- */ filename: '[name].js' } }
不知不觉时间又过去,啰嗦一堆堆的,每个项目需求都不一样,配置也会有许不同,也希望更多的朋友分享自己的代码和想法出来哈,也可以一起交流。
有需要一起交流的可以加我的微信,amwhuang,记得备注技术交流哈。
首发博客地址:http://lanchenglv.com/article/2016/0826/vue-cli_webpack_multi-page.html