跳到主要內容

webpack2 入門實戰 3 scss,html,file-loader

大家好,我是奶綠茶
上一篇介紹了 webpack 的核心功能 loader
這篇再來補強各種常用的 loader
css-loader:解悉 css 檔
extract-loader:這個有點難翻,下面會介紹
file-loader:存成實體的檔案, 如圖片
html-loader:解悉 html 檔
sass-loader:解悉 scss 檔
url-loader:解悉圖片路徑
webpack.config.js

module.exports = {
    resolveLoader: {
        // 所有用到的 loader,  -loader 可以不用打
        moduleExtensions: [ "-loader" ], 
    },
    resolve: {
        // 在 require 檔案, 如果不想寫完整的路徑
        // 可以加入這些目錄, 讓 webpack 自動尋找對的檔案
        // 請注意我們加入了 src/img 路徑,後面會再介紹到
modules: [  
            path.resolve( 'src/html' ),
            path.resolve( 'src/img' ),
            path.resolve( 'src/css' ),
            path.resolve( 'src/js' ),
            path.resolve( "node_modules"),
        ],
        // 在 require 時可以不用打副檔名
        extensions: [ ".js", ".scss" ] 
    },
}
再來就是 loader 的介紹
scss
在這要做多組合的應用
先將 .scss 透過 scss-loader 轉換, 並產生 sourceMap 檔
再過 css-loader
最後再過 style-loader

{
 test: /\.scss$/,
 // 多個 loader 組合, 可寫成一行,或是使用 use, 
 // 處理順序是由後往前
 // loader: 'style!css?sourceMap!sass?sourceMap',
 use: [
  "style",                    
  "css?sourceMap",
  'sass?sourceMap'
 ],
 include: path.resolve( __dirname, "src/css" ),
 exclude: /(node_modules|bower_components)/,
},


html
最終要產生實體的 html 檔
1. 直接用 file-loader 產生
會發現 html 變成了 js code
而且圖片也沒有處理
2. 過 extract-loader
再過 file-loader ,
產生的 html 才是我們要的
那圖片是怎麼處理的呢?

{
 // https://github.com/webpack-contrib/html-loader
 test: /\.html$/,
 // 只用 html-loader , 會把 html 的 code 包在 js 裡,不是我們要的
 // loader: 'html', 
 // 只用 file-loader , 只會單純的 copy 過去, 不會處理 img src 的圖片
 // loader: 'file?name=[name].html', 
 loader: 'file?name=[name].[ext]!extract!html',
 include: [ path.resolve( __dirname, "src/html" ) ],
 exclude: /(node_modules|bower_components)/,
},


jpg,png圖片
extract-loader 或是 css-loader ,遇到圖片路徑,
會再轉給 webpack 其他的 loader 處理
正規副檔名是 png,jpg,gif,svg,ico 就使用 url-loader
如果圖片小於 2048k 就轉成 base64 字串
否則就自動改用 file-loader 來處理
這部份就是 webpack 的強項
同檔名圖片,會因為使用者快取,看不到你更新的圖片
所以在 name 的參數,加入了一個 hash 參數
本來的 html img src="xxxxx.jpg"
經過 url-loader 轉換後, 就變成 "xxx.jpg?f5240920e4"
而且只有過 url-loader 的圖片,才會被處理
最終上線的圖片,就只會有用到的圖片檔

小技巧
在 html, css 要寫圖片路徑,以前都要寫完整的相對路徑
在 webpack 下,可以縮寫成 "~xxxx.jpg" ,前面加入小蚯蚓
記得在 resolve modules 加入圖片路徑


{
 test: /\.(png|jpg|gif|svg|ico)$/,
 use: [
  {
   loader: 'url',
   options: {
    // 小於 2048k 的圖檔, 自動變成 base64 字串
    limit: 2048,
    // 檔名: asset/[字資料夾][檔名].[副檔名]?[檔案的hash]
    name: "asset/[path][name].[ext]?[hash:10]",
   },
  },
 ],
 include: path.resolve( 'src/img' ),
 exclude: /(node_modules|bower_components)/,
},


webpack 打包後, 就可以看到最終產生的所有檔案
等一下!!!!!!!!!!!!!!!!! 怎麼沒有 css 檔 ??
因為目前的 scss 設定,預設會把 style 通通都寫在 js 檔裡
並在執行網頁時, 動態的注到 style tag 到你的 html
如果想產生實體的 css 檔,我們的 loader 規則就要換一下

回去看一下剛剛的 scss 設定
我們採用的組合是 style!css!scss
其中的 style-loader 就是產生 js 注入用的程式碼
改用

{
 test: /\.scss$/,
 use: [
  // "style", // 如果要用 extract-loader , 就不要加 style-loader
  "file?name=asset/[path][name].css",
  "extract?publicPath=../../",
  "css?sourceMap",
  'sass?sourceMap'
 ],
 include: path.resolve( __dirname, "src/css" ),
 exclude: /(node_modules|bower_components)/,
},

小結一下
webpack 每個 loader 都只做一件事
有時要產生想要的結果,需要用多組 loader 組合

轉載請註明出處
Github Source Code

留言

匿名表示…
Webpack 2 新推出相對 webpack 1 query 的 options,讓 loader 功能更強大,可讀性更高,你的 demo 沒講到,而且用法都沒統一是怎樣?

而且官方也不推薦 resolveLoader.moduleExtensions,你有仔細讀官方的 document 嗎?寫不好就認真讀 document 吧。
milkmidi寫道…
謝謝指教,我會再修正,謝謝

這個網誌中的熱門文章

webpack2 入門實戰 1

大家好,我是奶綠茶
前端戰場不再只是寫寫 js / css , 各種框架、前處理工具百花齊放
身為前端工程師,不只要把程式寫完,還要寫好
老師說:選對好工具,事情就完成一半
如果你還在一隻 JS 打完全部程式,一隻 css 寫所有的 style
每次存檔還在手動 reload 網頁, 圖片壓 K 壓到不要不要的
透過奶綠伯的系列教學,讓你了解 webpack2 帶來的優勢
學會 webpack 可能不會加薪,但至少可以準時下班(誤)
1. 安裝 nodejs
請參考 gulp 安裝編

2. 安裝 global webpack , 筆者使用的是 2.2.1 版本
npm i webpack@2.2.1 -g
3. 在專案的根目錄放一隻 webpack.config.js
entry:你的主 js 進入點
output.filename:webpack 打包後的檔名
output.path:webpack 打包後的路徑
var path = require('path'); module.exports = { entry: './src/app.js', output: { filename: 'bundle.js', path: path.resolve(__dirname, 'dist') } };
4. require , module.exports
現在前端都 module 化
可以每個獨立的功能都寫成單一的 js module
除了好管理,也方便讓團隊使用
寫一隻 module_exports_util.js
每隻經過 webpack 打包的 js , 都會是獨立的檔案
所以變數都是私有的, 外部成員都無法得到
在這個 module 裡,我們想開放二個函式
add , getName
所以在最後的 module.exports 指定
筆記加入 jsdoc , 為了方便在開發時,能夠有型別的提示

var name = "milkmidi"; /** * @param {number} num1 * @param {number} num2 * @return {number} */ function ad…

超好用的無限免費網頁空間,無廣告,無流量限制

大家好,我是奶綠茶
今天來教大家如何申請一個無限免費速度又快的網頁空間
1 首先到 https://github.com/ 申請帳號(一直下一步,下一步,下一步)
2 到你的個人頁,切換上方的 tab 到 Repositories, 按下右鍵的 new

3 Repository name
一定要是這樣的格式 username.github.io
我的 github 網址是 github.com/milkmidi
那就要輸入 milkmidi.github.io
選擇 public, 這樣別人才看的到
private 有其他用途, 而且要付費才能使用
完成後按下 Create repository


5 安裝 SourceTree
github 並不支援 FTP 或是網頁上傳,一定要透過指令碼
在這我們選用有圖型介面的軟體,方便大家學習
https://www.sourcetreeapp.com/
下載並安裝
啟動後登入你的 github 帳號

6 clone 你的 github io 專案
右上角有個 Clone or download 點選後
複製 https 連結(不要選到 ssh )


7 將 https 的連結貼到 SourceTree



8 上傳 html
到本機 github.io 資料夾,放一個 index.html
切換到 SourceTree, 這時會看到 Unstaged files 的欄位
選擇 Stage All


9 git 要求每次的 Commit, 都一定要打說明文字(好習慣)
輸入完成後,按下右邊的 Commit


10 發佈(Push),這樣就完成啦
可以到你的 http://milkmidi.github.io/ 去查看檔案有沒有出來


其他
Commit 可以想像是做一個記錄,你可以很多的 Commit
最後再一次 Push 上去
github 原本是給程式設計師用的版本控管服務
免費版提供無限空間讓你放檔案,但一定要是 public
想要有私有的 Project ,就只能付費
github.io 只能放靜態檔案,php, aspx 服務並不支援。
祝大家學習愉快

轉載請註明出處

奶綠的 github.io Source Code