本文基於vue1.x
基於vue2.x&webpack2.x請移步至
記得第一次知道Vue.js是在勾三股四大大的微博,那時候他開始翻譯vue的文檔,從那時候開始到現在,看了幾次vue的教程,每次都有更深的理解,因為之前並沒有研究過angular等框架,所以對MVVM並不是很了解,但是經過這段時間對vuejs的一些研究,越來越懂了,這篇文章,只是對vuejs和webpack配合的非常基礎的文章,我想隨着我對vue的深入理解,會對組件化,模塊化,MVVM有更深入的理解。
項目的創建
1.新建項目文件夾,並在其中建立package.json
$ mkdir [project name]
$ cd [project name]
$ npm init
2.在項目目錄下新建index.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Vue example</title> </head> <body> <div>{{message}}</div> <script src="dist/build.js"></script> </body> </html>
src文件夾,並在該文件夾下建立main.js
import Vue from 'vue' new Vue({ el:'body', data:{ message:'test success!' } });
設置webpack
1.安裝webpack,webpack-dev-server以及相關的loaders
# 全局安裝webpack,webpack-dev-server $ npm install -g webpack $ npm install -g webpack-dev-server # 為項目安裝其他依賴 $ npm i webpack-merge css-loader style-loader file-loader url-loader babel-core babel-loader babel-plugin-transform-runtime babel-preset-es2015 babel-preset-stage-0 babel-runtime vue vue-loader vue-html-loader vue-style-loader vue-hot-reload-api -D
webpack-merge:開發環境和生產環節的webpaak配置文件的配置合並<br/>
css-loader:編譯寫入css<br/>
style-loader:把編譯后的css整合進html<br/>
file-loader:編譯寫入文件,默認情況下生成文件的文件名是文件名與MD5哈希值的組合<br/>
vue:vue主程序<br/>
vue-laoder:編譯寫入.vue文件<br/>
vue-html-loader:編譯vue的template部分<br/>
vue-style-loader:編譯vue的樣式部分<br/>
vue-hot-reload-api:webpack對vue實現熱替換<br/>
babel-core:ES2015編譯核心<br/>
babel-loader:編譯寫入ES2015文檔<br/>
babel-preset-es2015:ES2015語法<br/>
babel-preset-stage-0:開啟測試功能<br/>
babel-runtime:babel執行環境<br/>
url-loader
這里介紹下url-loader,這個loader實際上是對file-loader的封裝https://github.com/webpack/url-loader
比如CSS文件中有時候會這么寫:
.demo{ background-image: url('a.png'); }
module:{ loaders:[ {test:/\.(png|jpg)$/,loader:'url-loader?limit=8192'} ] }
經過以上配置,當a.png小於8K就會自動將圖片轉換成base64編碼,如果不小於,則不會轉換。
這里順便提一句,在module配置的時候,loader的寫法:
module:{ loaders:[ {test:/\.jade$/,loader:'jade'} //這里配置了讓webpack識別jade的loader,其他類似,比如.vue //用於css文件的loader有兩種寫法 {test:/\.css$/,loader:'style!css'} {test:/\.css$/,loaders:['style','css']} ] }
2.配置webpack.config.js
在根目錄下建立webpack.config.js,配置如下:
var path = require('path'); module.exports = { entry: './src/main.js', //定義webpack輸出的文件,我們在這里設置了 讓打包后生成的文件放在dist文件夾下的build.js文件中 output: { path: './dist', publicPath:'dist/', filename: 'build.js' }, module: { loaders: [ //轉化ES6語法 { test: /\.js$/, loader: 'babel', exclude: /node_modules/ }, //圖片轉化,小於8K自動轉化為base64的編碼 { test: /\.(png|jpg|gif)$/, loader:'url-loader?limit=8192' } ] }, //這里用於安裝babel,如果在根目錄下的.babelrc配置了,這里就不寫了 babel: { presets: ['es2015','stage-0'], plugins: ['transform-runtime'] } }
特別說明
如果要在.babelrc下配置babel,則需要在根目錄下新建該文件,windows環境下,不能新建該txt文件然后改后綴,需要通過dos命令建立:
echo>.babelrc
通過該命令就可以建立babelde配置文件,用編輯器打開,修改里面的內容為:
{
"presets": ["es2015", "stage-0"], "plugins": ["transform-runtime"] }
完成該配置我們在命令中運行
$ webpack
打開index.html就可以看到瀏覽器中看到我們剛剛寫的文字
至此我們實現了最基本的利用webpack打包vue,下一篇將講解如何利用webpack+vue真正實現組件化。
本地安裝npm包后如何在命令行運行
在npm安裝包的時候,如果使用全局安裝,即npm install <packageName> -g,則在安裝完成后可以在終端運行作為命令去運行,但是如果是本地安裝的包npm install --save-dev <packageName>,則無法這樣直接運行。那么如何運行本地安裝的包呢?首先進入項目目錄(即package.json所在目錄),然后使用以下命令即可運行:
$ node_modules/.bin/<packageName>
除了可以這樣在命令行運行外,還可以在文件中運行
//index.js let webpack = require('webpack'); webpack();
$ node index.js
webpack1.x升級2.x
1.module.loaders改成了module.rules
舊的loaders被新的rules取代,后者允許配置loader以及其他更多項。
module: { - loaders: [ + rules: [ { test: /\.css$/, - loaders: [ + use: [ { loader: "style-loader" }, { loader: "css-loader", - query: { + options: { modules: true } ] }, { test: /\.jsx$/, loader: "babel-loader", // Do not use "use" here options: { // ... } } ] }
以上寫法中,Rule.loader是Rule.use: [ { loader } ]的簡寫。
2.鏈式調用loaders
在webpack1.x中loaders可以鏈式調用,在2.x中依舊有該特性,使用rule.use配置項,use中設置一個loaders的數組而在1.x中使用!連接各個loader,舊版寫法只有在使用舊的module.loaders時有效。
module: { - loaders: { + rules: { test: /\.less$/, - loader: "style-loader!css-loader!less-loader" + use: [ + "style-loader", + "css-loader", + "less-loader" + ] } }
3.取消在模塊中自動添加-loader后綴
webpack2.x中不再添加-loader
module: { rules: [ { use: [ - "style", + "style-loader", - "css", + "css-loader", - "less", + "less-loader", ] } ] }
根據官方說法,做出這樣更改的原因是省略-loader會對新手造成誤解,所以去掉這個功能,如果想打開這個舊的功能,可以配置resolveLoader.moduleExtensions,但是並不推薦這么做,具體參閱issues#2986
+ resolveLoader: {
+ moduleExtensions: ["-loader"] + }
4.使用options配置loader
在webpack1.x中可以通過webpack.config.js的自定義屬性來配置loader,這在webpack2.x中無法執行
module.exports = { ... module: { use: [{ test: /\.tsx?$/, loader: 'ts-loader' }] }, // does not work with webpack 2 ts: { transpileOnly: false } } //webpack2 use options module.exports = { ... module: { use: [{ test: /\.tsx?$/, loader: 'ts-loader' options: { transpileOnly: false } }] } }
webpack插件的使用
webpack-dev-server1.x升級2.x
1.在CLI使用的時候,--inline默認開啟,無需在輸入命令時添加
2.刪除contentBase用proxy代替
3.減少控制台無用輸出,在1.x中,當我們停掉服務器后,控制台會一直輸出錯誤信息,但是在2.x中只會輸出[WDS] Disconnected!
extract-text-webpack-plugin
在使用webpack將vue_spa打包后,並不會出現css,因為css被打包入build.js,如果從vue組件中抽離出css,需要安裝插件extract-text-webpack-plugin,在使用的時候需要配合v2版本的才可以使用(如果使用了webpack2,則對應的插件版本都需要用v2版本)。具體配置如下:
module:{ rules:[ { test: /\.vue$/, loader: 'vue', options: { loaders:{ css: extractTextPlugin.extract({ loader: 'css-loader', fallbackLoader: 'vue-style-loader' }) } } } ] }, plugins: [ new webpack.HotModuleReplacementPlugin(), new extractTextPlugin({ filename:'/style.css', allChunks:true }) ],
在options中:
options.loader: string | object | loader[] (必填項) 這里的 loader(s) 用於將資源轉換為css導出模塊
options.fallbackLoader: string | object | loader[] 當css沒有被導出的時候這里的 loader(s) 會被使用 (即當在plugins模塊中設置allChunks:false的時候)
在plugins中:
filename:可以設置被導出的css文件的路徑以及名字
allChunks:從所有附加塊中提取(默認情況下,它只從初始塊中提取)
html-webpack-plugin
plugins: [
new htmlWwebpackPlugin({ filename: 'assets/admin.html' }), ]
title:用於生成文檔的document
filename:要注入的html文件,默認為index.html。可以自定義(例如:assets/admin.html)
inject:
true | ‘head’ | ‘body’ | false
將資源注入所給的template或templateContent,當設置為 true 或者 ‘body’,所有的資源會被注入到body底部。而head則會將js放到headelement
favicon: 在輸出的html中添加favicon
hash: true | false 如果為true,則將一個唯一的webpack編譯散列附加到所有包含的腳本和CSS文件。這對緩存清除很有用。
cache: true | false 如果為true(默認),嘗試僅在更改后才發出文件。
是否要更換preset?
webpack2.x默認支持es6的模塊,所以在編譯時候沒有必要將它們先轉換為CommonJS模塊再處理,所以在github中出現了babel-preset-es2015-webpack,但是這個模塊我在使用的時候出現了Cannot remove 'babel-plugin-transform-es2015-modules-commonjs' from the plugin list.的問題,根據babel-preset-es2015-webpack中的敘述以及issues#14可知,babel-preset-es2015已經支持不轉換模塊中的import和export,只需要設置.babelrc
{
"presets": [ [ "es2015", { "modules": false } ] ] }
