webpack實用配置


開車之前,先介紹一些npm的命令:

:D
進入D盤

mkdir webapp

創建webapp文件夾

cd webapp

進入webapp文件夾

mkdir webapp && cd webapp

以上兩步創建和進入文件夾可以合並為一步

npm init -y

快速生成package.json文件

npm install xxx --save-dev

//安裝模塊並加入到開發依賴中,比如webpack

npm install xxx --save

安裝模塊並加入到生產依賴中,比如Jquery

npm install xxx@2.3.0

下載指定版本

npm view webpack versions --json

如果忘記版本號,可以列出所有版本號

npm install -g cnpm --registry=https://registry.npm.taobao.org

下載淘寶鏡像源,國內npm下載很慢,而且有些包下下來貌似會有問題,比如node-sass。

下載之后就可以直接使用了,使用方式跟Npm一樣,只不過是改成cnpm

cls

清空命令提示符窗口內容




webpack

1. html篇

介紹完npm基本的東西后,下面開始擼webpack

有關webpack的基本概念建議到官網查看,解釋的更為清楚,下面只簡單介紹。

1.  在根目錄下生成package.json文件: npm init -y 2. 安裝webapck cnpm install webpack --save-dev 3. 創建webpack.config.js文件: echo > webpack.config.js

 
var path=require("path"); module.exports={ <!-- 要打包的文件 --> entry:"./index.js", output:{ <!-- 指定打包后的文件名字 --> filename:"bundle.js", <!-- 打包后的文件路徑 --> path:path.resolve(__dirname,"dist") } }
4.創建src目錄,並在src目錄下創建index.html, index.js文件並隨便輸一點東西

    window.onload=function(){ alert(1) } 
5.執行 webpack 命令,可以發現webpack幫我們在dist下生成了一個main.js文件,打開main.js並拖到最下面你會發現index.js的內容就在里面。 打包完之后,我們在dist生成了js文件,但是我們的index.html在src下面,你可以手動的復制src下的html文件到dist目錄下,並且將打包后的js文件引入。不過像我們這么懶的人,還是希望webpack能夠幫我們在dist下也生成index.html,要是能自動引入打包后的js文件,那就再好不過了。這時候,是時候來一發插件了。 6.cnpm install html-webpack-plugin --save-dev
修改webpack.config.js
var HtmlWebpackPlugin = require('html-webpack-plugin'); var path = require("path") module.exports = { entry:"./index.js", output: { path: path.resolve(__dirname, 'dist'), filename:"bundle.js", }, plugins: [new HtmlWebpackPlugin({ title: "測試" })] };
重新執行命令 webpack ,你會發現在dist下多生成了一個index.html文件,打開發現還有一個script的標簽引用着我們打包后的文件,nice。 不過問題又來了,html文件很簡陋,就是emmet幫我們生成的Html5文件,你可能希望還帶有更多的 meta標簽,像這樣的
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no"> <meta name="format-detection" content="telephone=no, email=no"/> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title></title> </head> <body> <header></header> <nav></nav> <div id="app"></div> <footer></footer> </body>
此時,你可以自己寫一個模板,只需要告訴html-webpack-plugin插件文件的位置就可以了。
修改webpack.config.js
plugins: [ new htmlWebpackPlugin({ title:"首頁", <!-- 指定模板位置 --> template:'./src/index.html', <!-- 指定打包后的文件名字 --> filename: 'index.html' }) ]
對於多疑症的你,打包多次后你可能會懷疑文件修改生效了沒有,此時你可以安裝clean-webpack-plugin插件,在每次打包時,先刪除原來的dist目錄,再重新打包,這樣就可以放心的睡覺,不用擔心門沒關了。
7.cnpm install clean-webpack-plugin --save-dev
plugins:[ new htmlWebpackPlugin({ title:"首頁", template:'./src/index.html', filename: 'index.html' }), <!-- 每次打包前先刪除dist目錄 --> new CleanWebpackPlugin(['dist']) ]

css篇

 

以往我們寫css都是寫好后手動通過link引入到html,使用webpack后,你將不再需要手動做這些操作,只需要在js文件中引入,webpack就能幫你搞定,不過需要一些loader和plugin的支持。

cnpm install --save-dev css-loade style-loader

修改webpack.config.js


###為了處理css文件我們需要多配置一個module參數,並使用css-loader來將css文件打包到成“字符串”到js文件中,並使用style-loader將打包后的字符串提取出來並append<style>標簽到head下面 var path=require("path"); var htmlWebpackPlugin=require('html-webpack-plugin'); var CleanWebpackPlugin = require('clean-webpack-plugin'); module.exports={ entry:{ main:'./src/index.js' }, output:{ filename:"bundle.js", path:path.resolve(__dirname,'dist') }, module:{ rules:[ <!-- test檢測到以xxx結尾的東西use對應的loader --> { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] } ] }, plugins:[ new htmlWebpackPlugin({ title:"首頁", template:'./src/index.html', filename:"index.html" }), new CleanWebpackPlugin(['dist']) ] }
哦,聽說你想用sass 預處理 器,那么只需要在use里加多一個sass-loader,並安裝依賴
cnpm install --save-dev sass-loader node-sass rules:[ { test: /\.scss$/, use: [ 'style-loader', 'css-loader',"sass-loader" ] } ]
什么,想要自動補全瀏覽器后綴autoprefixer?沒問題
cnpm install --save-dev postcss-loader rules:[ { test: /\.s?css$/, use: [ { loader: "style-loader" }, { loader: "css-loader" }, { loader: 'postcss-loader', options: { plugins: [ require('autoprefixer')({ browsers: ['last 10 versions'] }) ] } }, { loader: "sass-loader" } ] } ]

這里需要注意,use里面的執行順序是倒序的 ,,webpack會以倒敘的方式處理並將處理后的結果返回給上一個loader,最后通過style-loader將文件的內容append到head下面的style標簽里。

教練,我還想要自動刷新

當你修改一點文件后,你需要重執行命令新編譯文件,然后刷新頁面。如果你使用過gulp的自動刷新比如live-reload,那你也一定希望webpack也有同樣的功能,webpack-dev-server滿足你的需求並且能夠給你更多。

安裝webpack-dev-server到開發依賴  cnpm install --save-dev webpack-dev-server
<!-- 在package.json中加入: --> "scripts": { "dev": "webpack-dev-server" }
通過npm run dev即可執行創建一個服務器,打開localhsot:8080
此時再修改文件,你會發現頁面自動刷新了並且修改生效了,不過你看不到重新編譯后的文件在哪里,應為webpack-dev-server將文件編譯到了內存中 ,比起重新生成文件效率會更高,當然只適用於開發階段。
啟動服務后,如果你 還想讓他自己 打開Localhost,還想 使用模塊熱重載 ,可以加多一個配置
devServer:{ open:true, hot: true,// 告訴 dev-server我們想用HMR模式 }
開發的時候我們並不在意 style這種形式,但是我們希望在生產環境下 css能從js文件宏分離出來,我們希望能css能跟js並行加載,而且可以避免因為Js文件過大,加載慢而產生的flash of unstyle(無樣式頁面閃爍)。
使用“extract-text-webpack-plugin”插件來分離css代碼。 

修改webpack.config.js

cnpm install --save-dev extract-text-webpack-plugin
var path=require("path"); var webpack=require('webpack'); var htmlWebpackPlugin=require('html-webpack-plugin'); var CleanWebpackPlugin = require('clean-webpack-plugin'); var ExtractTextPlugin = require("extract-text-webpack-plugin"); var extractSass = new ExtractTextPlugin({ filename: "[name].[contenthash].css", disable: process.env.NODE_ENV === "development" }); //通過設置環境變量來告訴webpack我們在development模式下不需要提取css到單獨在文件,只有當不是development下(也即是production)才需要提取文件。 module.exports={ entry:{ main:'./src/index.js' }, output:{ filename:"bundle.js", path:path.resolve(__dirname,'dist') }, devServer:{ open:true, hot: true, <!-- 告訴 dev-server我們想用HMR模式 --> }, module:{ rules:[ { test: /\.s?css$/, use: extractSass.extract({ use: [ { loader: "css-loader" }, { loader: 'postcss-loader', options: { plugins: [ require('autoprefixer') ] } }, { loader: "sass-loader" }], fallback: "style-loader" }) } ] }, plugins:[ <!-- 使用此插件來支持熱重載 --> new webpack.HotModuleReplacementPlugin(), new htmlWebpackPlugin({ title:"首頁", template:'./src/index.html', filename:"index.html" }), new CleanWebpackPlugin(['dist']), extractSass ] }

修改package.json ,本人為window10系統

"scripts": { "dev": "set NODE_ENV=development&&webpack-dev-server", "build":"webpack -p" }
分別執行npm run dev以及npm run build,你會發先npm run build時css文件被提取到一個單獨的文件了。

 

js篇

--------------------------------好累啊下面直接上代碼了

為了使用promise,async等es6,7語法,同時兼容低版本瀏覽器,你還需要將js轉碼為es5。

你需要安裝以下依賴包
cnpm install --save-dev "babel-core": "^6.25.0", "babel-loader": "^7.0.0", "babel-plugin-transform-object-rest-spread": "^6.23.0", "babel-plugin-transform-runtime": "^6.23.0", "babel-preset-env": "^1.5.2", 在module下增加: { test: /\.js$/, exclude: /node_modules/, use: { loader: 'babel-loader', options: { presets: ['env'], plugins: ['transform-runtime'] } } }

寫一點async或者prmise代碼,打包后發現promise變成了_promise2

 

代理



前后端分離開發時經常還會遇到跨域的問題,還可以利用devServer來進行代理

 devServer:{ open:true, hot: true, proxy: { '/api/': { target: 'http://baidu.com', secure: false, changeOrigin: true } } $.ajax({ url:'/api/', success:function(res){ console.log(res) }, error:function(res){ console.log(res) } })

圖片,字體篇

{ test: /\.(png|jpe?g|gif|svg)(\?.*)?$/, loader: 'url-loader', query: { limit: 8000, <!-- 小於8k的轉化為Base64 --> name: '[name].[hash:7].[ext]' } }, { test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/, loader: 'url-loader', query: { limit: 8000, name: 'font/[name].[hash:7].[ext]' } }
你可能想要把所有img或者font文件分別放到一個img或者font文件夾下,可以這么寫:name: 'img/[name].[hash:7].[ext]' 

 

如果你不想下載字體文件下來,可已上傳到阿里字體庫並使用阿里的在線字體圖標,並復制自己的文件的在線地址。

 

在css里面像這么用:@import url("//at.alicdn.com/t/font_s0zqwb6by3lhm2t9.css"); 

打包多文件

var path=require("path"); var webpack=require('webpack'); var htmlWebpackPlugin=require('html-webpack-plugin'); var CleanWebpackPlugin = require('clean-webpack-plugin'); var ExtractTextPlugin = require("extract-text-webpack-plugin"); var extractSass = new ExtractTextPlugin({ filename: "[name].[contenthash].css", disable: process.env.NODE_ENV === "development" }); module.exports={ entry:{ "main":'./src/js/index.js', "car":"./src/js/car.js", "goods":"./src/js/goods.js" }, output:{ filename:"[name].[hash].js", path:path.resolve(__dirname,'dist') }, devServer:{ open:true, hot: true, proxy: { '/api/': { target: 'http://baidu.com', secure: false, changeOrigin: true } } }, module:{ rules:[ { test: /\.s?css$/, use: extractSass.extract({ use: [ { loader: "css-loader" }, { loader: 'postcss-loader', options: { plugins: [ require('autoprefixer')({ browsers: ['last 10 versions'] }) ] } }, { loader: "sass-loader" }], fallback: "style-loader" }) }, { test: /\.js$/, exclude: /node_modules/, use: { loader: 'babel-loader', options: { presets: ['env'], plugins: ['transform-runtime'] } } }, {       test: /\.html$/,       use: ['html-withimg-loader']     }, { test: /\.(png|jpe?g|gif|svg)(\?.*)?$/, loader: 'url-loader', query: { limit: 8000, name: 'img/[name].[hash:7].[ext]' } }, { test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/, loader: 'url-loader', query: { limit: 8000, name: 'font/[name].[hash:7].[ext]' } } ] }, plugins:[ new webpack.HotModuleReplacementPlugin(), new htmlWebpackPlugin({ title:"首頁", template:'./src/index.html', filename:"index.html", chunks:["page/main/main"] }), new htmlWebpackPlugin({ title:"購物車", template:'./src/index.html', filename:"car.html", chunks:["page/car/car"] }), new htmlWebpackPlugin({ title:"商品", template:'./src/index.html', filename:"goods.html", chunks:["page/goods/goods"] }), new CleanWebpackPlugin(['dist']), extractSass, new webpack.ProvidePlugin({ $:"jquery", jQuery:"jquery" }) ] }
上面這樣寫打包后文件都放在一個目錄下,目錄很亂,不方便管理,想讓每個頁面的js,css文件放在對應目錄下,可以按下面這么寫
entry:{ "page/main/main":'./src/js/index.js', "page/car/car":"./src/js/car.js", "page/goods/goods":"./src/js/goods.js" }
如果多個文件都引用了一些其他庫,比如Jquery,vue,你可能想把所有的公共庫提取出來,利用common-chunk插件可以解決。即使你做的是spa單頁面應用,你也可以將公共庫從js文件中提取出來,每次修改時只修改業務邏輯而不重新打包庫,從而可以緩存庫文件。
entry:{ "main/main":'./src/js/index.js', "car/car":"./src/js/car.js", "goods/goods":"./src/js/goods.js" "vendor":["jquery","vue"] }, plugins:[ new htmlWebpackPlugin({ ...同上 chunks:["page/main/main","vendor","mainfest"] }), new htmlWebpackPlugin({ ... chunks:["page/car/car","vendor","mainfest"] }), new htmlWebpackPlugin({ ... chunks:["page/goods/goods","vendor","mainfest"] }), new webpack.optimize.CommonsChunkPlugin({ name:["vendor","mainfest"] }) ]
發現一個問題,在公司電腦dev-server-open自動打開的地址后面會帶undefined,去掉undefined打開網址才正常

 

代碼文件可以上github查看

https://github.com/linrunzheng/webpackGuide

常用的配置就這樣了,其他配置可以去webpack官網看。如果覺得本文對你有所幫助,麻煩點個start或者贊

webpack3都出了,你還不會2嗎?

 

 

前面的話

  上文介紹了webpack入門,本文將詳細介紹webpack實用配置

 

版本號

  以entry.js打包為bundle.js為例,出口的filename可以設置為[id]、[name]、[hash]、[chunkhash]等替換形式,如下所示

復制代碼
var webpack = require('webpack');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: '[id]-[name]-[hash].js'//出口名稱
  }
}
復制代碼

  則出口文件為0-main-0c1dce21f6c5db455fb4.js

  如果index.html要引用打包后的js文件,由於文件名稱不確定,並不好解決。這時,就需要使用html-webpack-plugin插件。該插件並不是內置插件,所以需要安裝

npm install html-webpack-plugin

  HtmlWebpackPlugin簡化了HTML文件的創建,以便為webpack包提供服務。這對於在文件名中包含每次會隨着變異會發生變化的哈希的webpack bundle尤其有用

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: '[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      title: 'match',//生成的html文件的標題為'match'
      filename: 'index.html'//生成的html文件名稱為'index.html'
    })
  ]
}
復制代碼

  通過以上的配置,如果在當前路徑,index.html不存在,則生成;如果存在,則替換

  [注意]如果htmlwebpackplugin不進行配置,參數為空, plugins: [new HtmlWebpackPlugin()]。默認地,生成的html文件名稱為'index.html',標題為'Webpack APP' 

【標簽位置】

  htmlwebpackplugin插件的常用設置是設置script標簽插入的位置,默認插入到body標簽中,但可以使用inject:'head',設置插入到head標簽中

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      inject:'head',//將script標簽插入到head標簽中
      filename: 'index-[hash].html',//生成的html文件名稱為'index.html'
    })
  ]
}
復制代碼

【圖標設置】

  設置favicon屬性,可以設置網頁的小圖標

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      favicon:'./icon.ico'
    })
  ]
}
復制代碼

【壓縮】

  設置minify屬性,可以壓縮html文件,默認為false,即不壓縮

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      minify:{
          removeComments: true,//刪除注釋
          collapseWhitespace:true//刪除空格
      }
    })
  ]
}
復制代碼

  使用webpack打包后的index.html代碼如下

<!DOCTYPE html><html><head><meta charset="UTF-8"><title>Webpack App</title></head><body><script type="text/javascript" src="js/0-main-8128c0c26a4449da7a05.js"></script></body></html>

 

模板文件

  HtmlWebpackPlugin除了提供模塊版本號的功能,還可以使用模板文件

  例如,模板文件為template.html,內容如下

復制代碼
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>template</title>
</head>
<body>
<script src="test.js"></script>
<div>test</div>    
</body>
</html>
復制代碼

  webpack配置文件如下

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      filename: 'index-[hash].html',//生成的html文件名稱為'index.html'
      template:'template/template.html'//模板文件為'template.html'
    })
  ]
}
復制代碼

  生成的index-[hash].html以'template.html'文件為模板

  [注意]如果在htmlwebpackplugin中使用了模板,則指定title不會生效,因為要以模板的title為准  

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      title:'test',
      filename: 'index-[hash].html',//生成的html文件名稱為'index.html'
      template:'template/template.html'//模板文件為'template.html'
    })
  ]
}
復制代碼

【傳參】

  模塊文件當然是可以傳參的,一般地,使用ejs語法。例如,在模板文件中,使用<%= htmlWebpackPlugin.options.title %>,即可讀取htmlWebpackPlugin插件中'title'屬性的值

  [注意]模板文件中的'htmlWebpackPlugin'是固定的,不能隨意更改。與webpack.config.js文件中,require()該插件的命名無關

復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      title:'test',
      template:'template/template.html',//模板文件為'template.html'
      dateData: new Date() 
    })
  ]
}
//template.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title><%= htmlWebpackPlugin.options.title  %></title>
</head>
<body>
<div><%=htmlWebpackPlugin.options.dateData %></div>
</body>
</html>
復制代碼

【模板組件】

  下面利用模板組件組合成一個html文件,以ejs模板語言為例

復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      template:'template/template.html'})
  ]
}
//template.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>
<body>
<div>
    <% include  template/header.html %>
</div>
<ul>  
    <% var arr = [1,2,3,4,5] %>
    <% for(var i = 0; i < arr.length; i++){ %>  
        <li><%=arr[i] %></li>  
    <% } %>  
</ul>  
<div>
    <% include  template/footer.html %>
</div>
</body>
</html>
//header.html
<div>我是頭部</div>
//footer.html
<div>我是尾部</div>
復制代碼

  運行結果報錯,提示子模板加載失敗

  這是因為HtmlWebpackPlugin插件並不具備ejs模板語言所有的功能,其中一個就是不能識別<%include %>語句,這時需要安裝一個ejs-compiled-loader

npm install ejs-compiled-loader

  安裝完成后,修改配置文件如下,表示使用ejs-compiled-loader來編譯template.html

  [注意]該插件中的include路徑相對於webpack配置文件的位置,而不是模板文件template.html的位置

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
      template:'ejs-compiled-loader!template/template.html'})
  ]
}
復制代碼

  結果如下

 

多頁面

  對於多頁面來說,一般地,有多個入口文件。不同的html頁面輸出對應不同的入口文件。 插件plugins()是一個數組,每new一個HtmlWebpackPlugin(),就可以輸出一個html頁面。這里有兩個重要的屬性:chunks和excludeChunks,chunks表示所包含的入口文件,excludeChunks表示要排除的入口文件

復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: {
      a:'./src/js/a.js',
      b:'./src/js/b.js',
      c:'./src/js/c.js'
  },
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
          filename:'a.html',
          template:'src/template/template.html',
          title:'this is a',
          chunks:['a']
    }),
    new HtmlWebpackPlugin({
          filename:'b.html',
          template:'src/template/template.html',
          title:'this is b',
          chunks:['b']
    }),
    new HtmlWebpackPlugin({
          filename:'c.html',
          template:'src/template/template.html',
          title:'this is c',
          excludeChunks:['a','b']
    }),    
  ]
}
復制代碼

  結果如下

復制代碼
//a.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>this is a</title>
</head>
<body>
<div></div>
<script type="text/javascript" src="js/2-a-9828ea84bd8c12c19b5f.js"></script></body>
</html>

//b.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>this is b</title>
</head>
<body>
<div></div>
<script type="text/javascript" src="js/1-b-9828ea84bd8c12c19b5f.js"></script></body>
</html>

//c.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>this is c</title>
</head>
<body>
<div></div>
<script type="text/javascript" src="js/0-c-9828ea84bd8c12c19b5f.js"></script></body>
</html>
復制代碼

 

內聯

  在前面的例子中,都是以鏈接的形式引入入口文件的。有時,為了追求性能,會將其處理為內聯的形式。這里就需要安裝一個擴展插件html-webpack-inline-source-plugin,專門用來處理入口文件內聯的

$ npm install --save-dev html-webpack-inline-source-plugin

  該插件的使用很簡單,使用require()語句引入后,在插件plugins()新建一個html-webpack-inline-source-plugin對象,然后在html-webpack-plugin對象中添加inlineSource屬性即可

inlineSource: '.(js|css)$' // embed all javascript and css inline
復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
var HtmlWebpackInlineSourcePlugin = require('html-webpack-inline-source-plugin');

module.exports = {
  entry: './entry.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  plugins: [
    new HtmlWebpackPlugin({
        inlineSource: '.(js|css)$'
    }),
    new HtmlWebpackInlineSourcePlugin()
  ]
}
復制代碼

  結果如下

復制代碼
<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>Webpack App</title>
  </head>
  <body>
  <script type="text/javascript">/******/ (function(modules) { // webpackBootstrap
/******/     // The module cache
/******/     var installedModules = {};
/******/
/******/     // The require function
/******/     function __webpack_require__(moduleId) {
/******/
/******/         // Check if module is in cache
/******/         if(installedModules[moduleId]) {
/******/             return installedModules[moduleId].exports;
/******/         }
/******/         // Create a new module (and put it into the cache)
/******/         var module = installedModules[moduleId] = {
/******/             i: moduleId,
/******/             l: false,
/******/             exports: {}
/******/         };
/******/
/******/         // Execute the module function
/******/         modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
/******/
/******/         // Flag the module as loaded
/******/         module.l = true;
/******/
/******/         // Return the exports of the module
/******/         return module.exports;
/******/     }
/******/
/******/
/******/     // expose the modules object (__webpack_modules__)
/******/     __webpack_require__.m = modules;
/******/
/******/     // expose the module cache
/******/     __webpack_require__.c = installedModules;
/******/
/******/     // identity function for calling harmony imports with the correct context
/******/     __webpack_require__.i = function(value) { return value; };
/******/
/******/     // define getter function for harmony exports
/******/     __webpack_require__.d = function(exports, name, getter) {
/******/         if(!__webpack_require__.o(exports, name)) {
/******/             Object.defineProperty(exports, name, {
/******/                 configurable: false,
/******/                 enumerable: true,
/******/                 get: getter
/******/             });
/******/         }
/******/     };
/******/
/******/     // getDefaultExport function for compatibility with non-harmony modules
/******/     __webpack_require__.n = function(module) {
/******/         var getter = module && module.__esModule ?
/******/             function getDefault() { return module['default']; } :
/******/             function getModuleExports() { return module; };
/******/         __webpack_require__.d(getter, 'a', getter);
/******/         return getter;
/******/     };
/******/
/******/     // Object.prototype.hasOwnProperty.call
/******/     __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
/******/
/******/     // __webpack_public_path__
/******/     __webpack_require__.p = "";
/******/
/******/     // Load entry module and return exports
/******/     return __webpack_require__(__webpack_require__.s = 0);
/******/ })
/************************************************************************/
/******/ ([
/* 0 */
/***/ (function(module, exports) {

document.write('It works.')

/***/ })
/******/ ]);</script></body>
</html>
復制代碼

 

babel

  下面使用babel來進行es最新標准的代碼向es5代碼的轉換,首先需要安裝babel核心程序,及babel-loader

npm install babel-loader babel-core 

  在使用babel-loader進行代碼轉換之前,要先了解到ecmascript標准變化很快,且瀏覽器支持情況不同。所以,出現了'es2015'、'es2016'、'es2017'、'latest'、'env(new)'等多個不同的標准。這時,要需要來選擇從哪個標准進行轉換,需要安裝插件babel-preset-env 

npm install babel-preset-env 

  在 webpack 配置對象中,需要添加 babel-loader 到 module 的 loaders 列表中

復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      loaders:[{
          test:/\.js$/,
          use:{
              loader:'babel-loader',
              options:{
                  presets: ['env']
              }
          }
      }]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}
復制代碼
//app.js
let num = 1;
console.log(num);

【打包速度】

  運行后,頁面控制台輸出1,轉換正常。但是,babel的轉換過程卻很慢

  前面的博文webpack的四個基本概念,我們介紹過loader的test屬性表示該loader必須滿足的條件,上面代碼中使用/\.js$/ 來匹配,這樣也許會去轉譯 node_modules 目錄或者其他不需要的源代碼。這樣會大大增加webpack的編譯時間

  要排除 node_modules,就要使用 loaders 配置的 exclude 選項,表示哪些除外,exclude:/node_modules/

  [注意]exclude也應該用正則的形式,如果用__dirname +'/node_modules'的形式則不會生效

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      loaders:[{
          test:/\.js$/,
          exclude: /node_modules/,
          use:{
              loader: 'babel-loader',
              options:{
                  presets: ['env']
              }
          }
      }]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}
復制代碼

  當然了,除了exclude選項,也有include選項,能夠明確被打包的文件時,使用include將使打包速度更快

  對於include來說,它比較特別,字符串形式__dirname + './src/'和正則形式/\.\/src/都支持,經過測試,這兩種形式的打包速度類似

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      loaders:[{
          test:/\.js$/,
          include:/\.\/src/,
          use:{
              loader: 'babel-loader',
              options:{
                  presets: ['env']
              }
          }
      }]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}
復制代碼

 

CSS

  在webpack入門博文中由介紹過CSS插件的簡單使用,接下來將詳細介紹

  首先,要安裝css-loader和style-loader,css-loader用於讀取並加載css文件,style-loader將它插入到頁面中

  [特別注意]在處理css時,最好不要使用include、exclude等屬性。include、exclude屬性是加快babel轉換速度的,和css沒什么關系,而且會添亂

npm install css-loader style-loader
復制代碼
//app.js
require('./css/common.css');
//common.css
body{margin: 0;background-color: red}
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      rules:[
          {
              test:/\.css$/,
              use:[ 'style-loader', 'css-loader' ]
          }
      ]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}
復制代碼

  效果如下

【自動前綴】

  頁面加載CSS往往並不像上面的情況這么簡單,需要處理很多問題,其中一個就是瀏覽器前綴問題。對於某些屬性來說,比如transform,不同瀏覽器的版本對其支持程度不同,瀏覽器前綴也不同。這時,就需要能夠根據實際情況,自動增加前綴,而postcss-loader就是這樣的工具,而且功能要強大的多

  首先,先安裝postcss-loader

npm install postcss-loader

  然后,安裝postcss的自動前綴的插件autoprefixer

npm install autoprefixer

  配置如下

復制代碼
//common.css
body{transform: scale(0);background-color: red}
//app.js
require('./css/common.css');
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      rules:[
          {
              test:/\.css$/,
              use:[ 'style-loader', 
                    'css-loader',                    
                    {
                        loader: 'postcss-loader',
                        options: {plugins: [require('autoprefixer')]}            
                    }
                 ]
          }
      ]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}
復制代碼

  結果如下

  如果css文件中出現@import,則有兩種處理方式,一種是將postcss文件單獨寫成配置文件postcss.config.js

復制代碼
//common.css
@import './flex.css';
body{transform: scale(0);background-color: red}
//flex.css
body{display:flex;}
//app.js
require('./css/common.css');

//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      rules:[
          {
              test:/\.css$/,
              use:[ 'style-loader', 
                  { loader: 'css-loader',
                    options: {importLoaders: 1} 
                  },
                'postcss-loader'
                ]
          }
      ]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}

//postcss.config.js
module.exports = {
 plugins:[require('autoprefixer')]
}
復制代碼

  結果如下

  另一種需要安裝postcss-import插件

npm install postcss-import
復制代碼
//common.css
@import './flex.css';
body{transform: scale(0);background-color: red}
//flex.css
body{display:flex;}
//app.js
require('./css/common.css');

//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      rules:[
          {
              test:/\.css$/,
              use:[ 'style-loader', 
                  { loader: 'css-loader',
                    options: {importLoaders: 1 } 
                  },
                  {
                    loader: 'postcss-loader',
                    options: {plugins: [
                          require('postcss-import'),
                          require('autoprefixer')
                        ]
                    }     
                  }
                ]
          }
      ]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}
復制代碼

  結果如下

【sass】

  首先,需要安裝sass-loader及node-sass

   [注意]關於node-sass安裝的問題移步至此

npm install sass-loader node-sass

  由於sass-loader中已經自帶了關於@import處理的問題。所以,不需要css-loader及postcss-loader的額外處理

復制代碼
//layer.scss
@import './flex.scss';
body{
    background-color:green;
    div{
        width: 400px;
    }
}
//flex.scss
.flex{display:flex;}
//app.js
require('./components/layer/layer.scss');

//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      rules:[
          {
              test:/\.scss$/,
              use:[    'style-loader', 
                      'css-loader',
                    {
                        loader: 'postcss-loader',
                        options: {plugins: [require('autoprefixer')]}            
                    },
                    'sass-loader'
                 ]
          }
      ]
  },
  plugins: [
    new HtmlWebpackPlugin({})
  ]
}
復制代碼

  結果如下

【分離CSS】

  默認地,CSS作為模塊資源被打包到入口js文件中。有時,需要把CSS文件分離出來,這時就需要用到extract-text-webpack-plugin插件

npm install extract-text-webpack-plugin

  該插件的配置如下

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
var ExtractTextPlugin = require('extract-text-webpack-plugin');
module.exports = {
  entry: './src/app.js',
  output:{
    path: __dirname,//出口路徑
    filename: 'js/[name].bundle.js'//出口名稱
  },
  module:{
      rules:[
          {
                  test:/\.scss$/,
                use: ExtractTextPlugin.extract({
                  fallback: 'style-loader',
                  use:[ 'css-loader',
                        {
                            loader: 'postcss-loader',
                            options: {plugins: [require('autoprefixer')]}            
                        },
                        'sass-loader'
                     ]
                })              
          }
      ]
  },
  plugins: [
    new HtmlWebpackPlugin({}),
    new ExtractTextPlugin("styles.css")
  ]
}
復制代碼

  結果如下,該插件將入口文件中引用的 *.css,移動到獨立分離的 CSS 文件。因此,你的樣式將不再內嵌到 JS bundle 中,而是會放到一個單獨的 CSS 文件(即 styles.css)當中。 如果樣式文件大小較大,這會做更快提前加載,因為 CSS bundle 會跟 JS bundle 並行加載

 

 

圖片資源

  webpack在處理圖片、音樂、電影等資源文件時,需要使用file-loader

npm install file-loader

  默認情況下,使用file-loader生成的文件的文件名就是文件內容的MD5哈希值並保留原始擴展名

  以引入圖片資源例,有以下幾種情況

  1、通過css文件的background屬性引入

復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  module:{

      rules:[
          {
              test:/\.css$/,
              use:[ 'style-loader', 'css-loader' ]
          },
          {
              test:/\.(png|jpg|gif|svg)$/i,
              use:'file-loader'
          }
      ]
  },  
  plugins: [
    new HtmlWebpackPlugin()
  ]
}
//entry.js
require('./src/css/common.css');
//common.css
body{background: url('../img/eg_bulbon.gif')}
復制代碼

  結果如下

  2、通過模板html文件img標簽引入,這時需要使用${require('')}將相對路徑包裹一次

復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname,//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  module:{
      rules:[
          {
              test:/\.css$/,
              use:[ 'style-loader', 'css-loader' ]
          },
          {
              test:/\.(png|jpg|gif|svg)$/i,
              use:'file-loader'
          }
      ]
  },  
  plugins: [
    new HtmlWebpackPlugin({
        template:'template/template.html'
    })
  ]
}
//template.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>
<body>
<img src="${require('../src/img/eg_bulbon.gif')}" alt="">
</body>
</html>
復制代碼

  結果如下

  3、若模板使用ejs-compiled-loader插件,則無法使用${require('')}語句,需要使用HtmlWebpackPlugin傳參來構造絕對路徑

復制代碼
//webpack.config.js
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
  entry: './entry.js', //入口文件
  output: {
    path: __dirname + '/dist',//出口路徑
    filename: 'js/[id]-[name]-[hash].js'//出口名稱
  },
  module:{
      rules:[
          {
              test:/\.css$/,
              use:[ 'style-loader', 'css-loader' ]
          },
          {
              test:/\.(png|jpg|gif|svg)$/i,
              use:'file-loader'
          }
      ]
  },  
  plugins: [
    new HtmlWebpackPlugin({
        template:'ejs-compiled-loader!template/template.html',
        file:__dirname
    })
  ]
}
//template.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>
<body>
<div>
    <% include  template/header.html %>
</div>
</body>
</html>
//header.html
<img src="<%=htmlWebpackPlugin.options.file%>\src\img\eg_bulbon.gif" alt="">
復制代碼

  結果如下

【file-loader參數】

  文件名模板占位符有如下幾種

復制代碼
[ext] 資源擴展名
[name] 資源的基本名稱
[path] 資源相對於 context 查詢參數或者配置的路徑
[hash] 內容的哈希值,默認為十六進制編碼的 md5
[<hashType>:hash:<digestType>:<length>] 可選配置
  其他的 hashType, 即 sha1, md5, sha256, sha512
  其他的 digestType, 即 hex, base26, base32, base36, base49, base52, base58, base62, base64
  length 字符的長度
[N] 當前文件名按照查詢參數 regExp 匹配后獲得到第 N 個匹配結果
復制代碼
復制代碼
{
  test:/\.(png|jpg|gif|svg)$/i,
  use:[{
              loader:'file-loader',
            options: {
                name:'[name]-[hash:5].[ext]'
            }  
        }]
}
復制代碼

  或者

{
  test:/\.(png|jpg|gif|svg)$/i,
  use:['file-loader?name=[name]-[hash:5].[ext]']
}

  結果如下

【url-loader】

  url-loader功能類似於file-loader,但是在文件大小(單位byte)低於指定的限制時,可以返回一個dataURL

  可以通過傳遞查詢參數(query parameter)來指定限制(默認為不限制)。

  如果文件大小超過限制,將轉為使用 file-loader,所有的查詢參數也會傳過去

npm install url-loader

  圖片的大小為1.1kb,下面將限制設置為2000,則圖片將以base64格式傳遞

{
  test:/\.(png|jpg|gif|svg)$/i,
  use:['url-loader?limit=2000']
}

  結果如下

  如果將限制大小設置為1000,圖片以src的形式傳遞

復制代碼
{
  test:/\.(png|jpg|gif|svg)$/i,
  use:[{
              loader:'url-loader',
            options: {
                limit:1000,
                name:'[name]-[hash:5].[ext]'
            }  
        }]
}
復制代碼

【image-webpack-loader】

  使用image-webpack-loader來壓縮圖片

npm install image-webpack-loader

  插件一張大小為4.1kb的名稱為'm.jpg'的圖片,配置如下

復制代碼
{
  test:/\.(png|jpg|gif|svg)$/i,
  use:[
    'url-loader?limit=1000&name=[name]-[hash:5].[ext]',
    'image-webpack-loader'
  ]
}
復制代碼

  結果如下所示,生成大小為3.28kb,名稱為'm-c7083.jpg'的圖片

 

實用配置

  下面將使用webpack搭建一個實用的開發環境

復制代碼
var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
var ExtractTextPlugin = require('extract-text-webpack-plugin');
module.exports = {
    entry: './src/app.js',//入口文件
    output:{
        path: __dirname,//出口路徑
        filename: 'js/[name].bundle.js'//出口名稱
    },
    module:{
        rules:[
            {
                test:/\.scss$/,
                use: ExtractTextPlugin.extract({
                    fallback: 'style-loader',
                     use:[ 
                             'css-loader',
                            {
                                loader: 'postcss-loader',
                                //自動添加前綴
                                options: {plugins: [require('autoprefixer')]}            
                            },
                            'sass-loader'
                        ]
                })              
            },
            {
                test:/\.js$/,
                include:/\.\/src/,
                use:{
                        loader: 'babel-loader',
                        //將最新標准的js代碼翻譯為es5代碼
                        options:{presets: ['env']}
                    }
            },
            {
                test:/\.(png|jpg|gif|svg)$/i,
                use:[
                        //當圖片大小大於1000byte時,以[name]-[hash:5].[ext]的形式輸出
                        //當圖片大小小於1000byte時,以baseURL的形式輸出
                        'url-loader?limit=1000&name=[name]-[hash:5].[ext]',
                        //壓縮圖片
                        'image-webpack-loader'
                    ]
            }
          ]
    },
    plugins: [
          //使用模板生成html文件
        new HtmlWebpackPlugin({template:'ejs-compiled-loader!template/template.html'}),
        //分離出css到style.css
        new ExtractTextPlugin("style.css")
    ]
}


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM