进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

Posted 腾讯IMWeb前端团队

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)相关的知识,希望对你有一定的参考价值。

前端爱好者的知识盛宴

这里是IMWEB

一个想为多的前端人

享知识 

助发展

觅福利

欢迎关注转发

让更多的前端技友一起学习发展~



文章来源:http://www.cnblogs.com/kenkofox

导语

一般来说,使用vue做成单页应用比较好,但特殊情况下,需要使用多页面也有另外的好处。例如手Q的多webview架构,新开页面有利于ios右划返回,也避免了返回时页面的刷新。


所以,这里我们探讨一下如何配置实现多页面的项目框架。这里是开篇,先以最简单的纯前端多页面为例入手,最终目标是完成Node.js多页面直出+前后端同构的架构。


本文源代码:https://github.com/kenkozheng/html5_research/tree/master/Vue-Multipages-Webpack3


目录

也是实现纯前端多页面的步骤


  •vue-cli创建框架


  •分析原型项目配置


  •多页面化改造



正文

1.利用vue-cli搭建基本的框架                     


vue-cli是官方提供的脚手架工具,快速建立原型项目。

  •安装vue-cli:npm i -g vue-cli

  •初始化项目:vue init <template-name> <project-name>


这里我选择最简单的template:webpack-simple。先创建项目目录,然后在目录内运行vue init webpack-simple,一路yes下去

然后,我们会得到这样的目录结构:

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

  •babelrc是babel的配置文件,详细看babel自身的介绍

  •editorconfig控制编辑器的文字样式之类的,可以删掉

  •gitignore是git的配置

  •index.html就是单页面的html

  •webpack.config.js已经区分了开发环境还是生产环境,生产环境加上uglify混淆

  •src目录中包括了页面的vue单文件(组件)和主入口main.js


2.运行分析原型项目                                      

vue-cli把project.json、webpack配置还有npm脚本都准备好了,很赞。

我们只需要两步即可运行项目

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

行npm run dev就可以启动默认的在8080端口监听的服务器,带有webpack热更新全家桶,非常方便。
不过,我们需要看懂里边所有源码,才能进行下一步的操作。


>.babelrc

细节的配置很多,原型项目使用了env这个插件,并设置module相关的语法不转义(留给webpack处理)

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)


>webpack.config.js

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

entry可以为数组或对象或单个字符串,指定需要打包的文件;
output指定打包后输出的信息。这里最好参考官方文档,实在不行就看源码,各种网上文章可能都会说错,包括我这一篇。

官方文档:https://doc.webpack-china.org/concepts/output/

关键点是,filename可以用[name].[hash:8]等关键字的方式实现根据entry输入而动态变化的文件名,后续会用到。
path和publicPath需要重点区分一下。


  •path指的是打包后输出的文件目录


进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

再看看module,这里从2.x开始就改了格式,一目了然,就是各种文件应该使用什么loader去加载处理。
主要需要关心最后这个file-loader,name要跟之前publicPath配合好,除了写文件名还可以写目录,webpack会自动创建目录存放文件。

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

resolve的alias目的是做一个别名映射,当代码中出现vue$时,可以动态替换为对应的字符串。
devServer控制webpack自带的热更新服务器的行为,例如修改一下端口。使用npm脚本运行:webpack-dev-server --open --hot。需要注意的是,devserver使用memory-fs,并不直接写文件系统。配合WriteFilePlugin可以强制写入。如果不使用devserver调试,例如fiddler替换,就需要强制写入文件系统了。
performance可以先略过
devtool是控制生成的源代码source-map功能,按照默认即可,具体的使用原理简单说,就是浏览器支持的混淆后代码映射到源文件的映射表。

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

最后判断了环境变量,如果是生产发布,再加上uglify插件。这里的参数设置可以参考uglify插件本身。
环境变量的设置,使用的是cross-env工具,在npm脚本中运行设置的cross-env NODE_ENV=production

>App.vue和index.html

这两个就是很基本的vue功能了。需要关注的是,现在只有一个index.html,而且index.html的功能比较单一纯粹引入js。做多页面时,html如何复用,是需要考虑的问题。


3. 多页面改造                                                

了解了原型项目的功能,接下来需要做的事情包括:


  •建立多页面项目目录,创建多个vue

  •webpack多entry配置

  •复用html/自动生成html

  •实际项目的一些优化


>创建多页面

如图所示

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)


>webpack多entry配置

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

主要是filename使用了动态的配置方式,会根据entry的key映射。


>自动化生成html

因为index.html内容简单,我们没必要每个页面都复制一份。而别人早就想到这个了,所以有了html-webpack-plugin。
老规矩,npm install起来

然后,修改webpack配置

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

根据pages数组的配置,自动建多个HtmlWebpackPlugin实例插到配置中。


顾名思义,配置起了比较简单,详情参考官网:https://github.com/jantimon/html-webpack-plugin


inlineSource是特殊的字段,后续再说。

至此,就可以把项目跑起来了,dev模式下,webpack每次自动打包都会生成page1和page2。


>一些项目优化

全局共用css的打包
在页面main.js中,直接import即可,最终会转换为注入到html的js代码。

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

图片打包文件名管理

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)

往往图片发布后都是长缓存,那么在文件名中加入hash做版本区分是个好方式。另外,使用独立的目录,更方便cdn设置缓存时间。


html、js、css打包到一起,减少请求


多页面决定了每个页面不会太大,对于目前的移动互联网来说,打包在一起的html会比多个js请求更快。
这我们需要用到HtmlWebpackInlineSourcePlugin,也就是刚才提到的inlineSource字段。

进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)


4.运行起来                                                   

下载代码:https://github.com/kenkozheng/HTML5_research/tree/master/Vue-Multipages-Webpack3


关注小编

留言夸夸小编

转发文章给小编加鸡腿

更多的人一起学习

让我们又爱又恨的前端


以上是关于进阶| Vue 2.x + Webpack 3.x + Nodejs 多页面项目框架(上篇)的主要内容,如果未能解决你的问题,请参考以下文章

vue-cli2.x与vue-cli3.x的搭建

vue-cli

对比vue-cli2.x和vue-cli3.x的搭建

vue-cli@3.x初体验之前篇-回顾vue-cli@2.x创建项目的流程

vue-cli 3.x 与vue-cli 2.x构建项目的区别

webpack进阶【19】: vue-cli 脚手架环境 反向代理服务器的配置