这是一系列文章,此系列所有的练习都存在了我的github仓库中vue-webpack,在本人有了新的理解与认识之后,会对文章有不定时的更正与更新。下面是目前完成的列表:
webpack入坑(一)不是开始的开始
webpack入坑之旅(二)loader入门
webpack入坑之旅(三)webpack.config入门
webpack入坑之旅(四)扬帆起航
webpack入坑之旅(五)vue单文件
webpack入坑之旅(六)配合vue-router实现spa
需要什么?
在经过前面的四个练习,相信已经对于webapck
有了一定的了解,现在我们就来一个综合案例,进一步加深对于webpack
的理解。
首先我们应该思考要解析.vue
类型的文件,需要什么样的东西?应该按照什么样的步骤来?我们应该怎么去搭建这个项目?
开始
第一步:初始化项目目录
我们需要创建如下目录及文件夹,最终目录结构如下:
1 2 3 4 5 6 7 8 9 10 11 |
- dist //文件生成目录 -- //自动生成 - node_module //自动安装 -- ... - src //文件入口 -- components //组件存放 -- app.vue //主.vue -- main.js //主.js - index.html //主.html - package.json //npm 配置 - webpack.cofig.js // webpack配置 |
第二步:安装项目依赖
如果你上面没有创建package.json
文件的话,可以直接使用npm init
来初始化我们的package.json
文件的配置。
想要去编译其他的文件比如react
,coffce
等等,就必须要加载很多对应的loader
。要想加载一个.vue
文件。当然也是同样的道理。
建议用npm install xxx-loader --save-dev
这样的命令一条一条的敲。在命令行中,会有提示,可以帮助理解webpack
的中的依赖管理关系。我的配置清单如下:
在实际项目中,json文件中不能出现注释,在这里为了方便大家了解里面设置项的含义,就直接使用注释的方式加载后面了。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 |
{ "name": "05-five-vue", //项目名称 "version": "1.0.0", //版本 "description": "vue webapck", //描述 "main": "index.js", //主文件 "scripts": { "test": "echo \"error: no test specified\" && exit 1", "start": "webpack-dev-server --inline" }, //scripts指定了运行脚本命令的npm命令行缩写,比如这是的start指定了运行npm run start时,所要执行的命令。 "dependencies": { //项目依赖 "vue": "^1.0.18" }, "devdependencies": { //各种各样的loader,用来解析想相应的文件格式。要解析vue并且完成相应的功能,这些基本都是必须的。 "autoprefixer-loader": "^2.0.0", "babel": "^6.3.13", "babel-core": "^6.3.21", "babel-loader": "^6.2.0", "babel-plugin-transform-runtime": "^6.3.13", "babel-preset-es2015": "^6.3.13", "babel-runtime": "^5.8.34", "css-loader": "^0.16.0", "file-loader": "^0.8.5", "html-loader": "^0.3.0", "node-sass": "^3.4.2", "sass-loader": "^3.2.0", "style-loader": "^0.12.3", "url-loader": "^0.5.6", "vue-html-loader": "^1.2.0", "vue-loader": "^7.2.0", "webpack": "^1.12.0", "webpack-dev-server": "^1.14.0" }, "author": "guowenfh", //作者 "license": "mit", //开源协议 "keywords": [ //关键字 "vue", "webpack" ] } |
如果你想省事的话,直接复制上面的devdependencies
,dependencies
字段,并且填写到你的package.json
文件中。然后运行npm install
就会自动安装所有的模块以及依赖。
第三步:配置webpack
文件已经设置好了,接下来就到了我们关键的一步,配置webpack.config.js
,清单如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 |
var path = require('path'); // nodejs中的path对象,用于处理目录的对象,提高开发效率。 // 模块导入 module.exports = { // 入口文件地址,不需要写完,会自动查找 entry: './src/main', // 输出 output: { path: path.join(__dirname, './dist'), // 文件地址,使用绝对路径形式 filename: '[name].js', //[name]这里是webpack提供的根据路口文件自动生成的名字 publicpath: '/dist/' // 公共文件生成的地址 }, // 服务器配置相关,自动刷新! devserver: { historyapifallback: true, hot: false, inline: true, grogress: true, }, // 加载器 module: { // 加载器 loaders: [ // 解析.vue文件 { test: /\.vue$/, loader: 'vue' }, // 转化es6的语法 { test: /\.js$/, loader: 'babel', exclude: /node_modules/ }, // 编译css并自动添加css前缀 { test: /\.css$/, loader: 'style!css!autoprefixer'}, //.scss 文件想要编译,scss就需要这些东西!来编译处理 //install css-loader style-loader sass-loader node-sass --save-dev { test: /\.scss$/, loader: 'style!css!sass?sourcemap'}, // 图片转化,小于8k自动转化为base64的编码 { test: /\.(png|jpg|gif)$/, loader: 'url-loader?limit=8192'}, //html模板编译? { test: /\.(html|tpl)$/, loader: 'html-loader' }, ] }, // .vue的配置。需要单独出来配置,其实没什么必要--因为我删了也没保错,不过这里就留这把,因为尊龙凯时网址官网文档里是可以有单独的配置的。 vue: { loaders: { css: 'style!css!autoprefixer', } }, // 转化成es5的语法 babel: { presets: ['es2015'], plugins: ['transform-runtime'] }, resolve: { // require时省略的扩展名,如:require('module') 不需要module.js extensions: ['', '.js', '.vue'], // 别名,可以直接使用别名来代表设定的路径以及其他 alias: { filter: path.join(__dirname, './src/filters'), components: path.join(__dirname, './src/components') } }, // 开启source-map,webpack有多种source-map,在尊龙凯时网址官网文档可以查到 devtool: 'eval-source-map' }; |
请详细查看这里面的设置,我这里都是很简单的配置,在你的项目中,还可以更进一步的对于入口文件和输出文件进行更加深入的定制。(注意:好像node-sass
的包有问题,有很多人解析不了sass
)
并且在这里生成的css文件还会插到js中,有时我们需要更进一步的把它独立出来,然后在html中引入这时就会用到webpack
的插件,在这里先不说(因为我暂时没用到,没有试验过,好像也不麻烦,可以的话下篇再试试)
第四步:编写代码
接下来就是我们要展示的文件的编写了,我直接把代码贴上来了。
index.html:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
|
这里是main.js的内容:
1 2 3 4 5 6 7 8 9 |
//es6语法: import vue from "../node_modules/vue/dist/vue.min.js";//其实不用写完,会自动查找。可以直接写import vue from "vue"; //外部引入别的库都可以用这样的方式,比如jquery等。。 //引入我们编写的测试用vue文件。 import app from './components/app'; vue.config.debug = true;//开启错误提示 new vue(app); |
这里是app.vue:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 |
姓名:{{name}}{{age}} |
第五步:修改自动刷新设置
下面再单独的再谈一下关于自动刷新的实现,首先需要说明,在上一篇博客中的自动刷新实现,是有问题的。只能改变css样式,使颜色进行变化。对于html里面的内容改变时,浏览器并不会自动刷新。
注意点一:
首先我们看到package.json
中scripts
字段中的"start": "webpack-dev-server --inline"
。这里如果按照网上的方法在后面再添加上--hot
的话,只会对于app.vue
中的标签内的css起效果。
注意点二:
因为我们没有加--hot
,所以在webpack.cofig.js
中需要对于devserver
进行一些配置,如下:(主要是是hot
设置为了false)。
1 2 3 4 5 6 |
devserver: { historyapifallback: true, hot: false, inline: true, grogress: true, } |
这样设置了之后按下保存相当于按下了f5浏览器整个刷新。而不是局部刷新。(如果你实现了局部刷新,并且没有其他问题,那请教教我^_^)
注意点三:
注意package.json
的loader安装中的"vue-hot-reload-api": "^1.2.2"
。它有可能是导致你不能自动刷新的凶手(我现在都没搞明白到底该安装,还是取消)
结束
步骤都走完了,因为在上面的package.json
中已经进行了scripts
项的配置。运行npm start
,打开localhost:8080
可以看到设置的背景色已经出来了,去改变一下背景颜色?data?template?
看看浏览器会不会自动刷新?
如果你按照我的步骤,并且,npm包安装没有错误的话,应该就能成功了。
不行的话,请再仔细对照去看看有什么地方没有编写对吧!