跳到主要內容

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…

Android完全入門篇-01 安裝SDK與裝置USBDriver

大家好,我是奶綠茶
筆者以 Windows 系統來介紹安裝
1. 下載 Android SDK
http://developer.android.com/sdk/index.html
有分 32 位元和 64 位元的版本
為了教學方便,筆者將檔案放置在 D:\ 下
壓開後會有
eclipse資料夾:Eclipse程式碼編譯器
sdk:Android 開發用的 SDK
SDK Manager.exe:sdk管理用的軟體


2. 開啟手機的"開發人員選項"
部份手機該選項被隱藏起來了
要開啟的話,點選"關於手機"
接著連點"版本號碼"七次,就會重新開啟該功能
接著再開啟"USB偵錯"功能
接上你的 USB 線後
這樣你的電腦才能透過 USB 線來偵錯手機的資訊
3. 為裝置安裝 adb usb driver
因為各家廠牌的 Driver 都不同也不通用,所以需要自行 Google 找 Driver
可以用"XXX廠牌 型號 adb usb driver"關鍵字來找
例:HTC Newone adb usb driver
接著找到 我的電腦 / 內容


裝置管理員

會看到一個金嘆號未知的裝置, 按右鍵更新驅動程式軟體

選擇"瀏覽電腦上的驅動程式軟體"

完成後就會看到裝置啟動,並出現 XXX Android ADB Interface

4.測試是否連接成功
進入到第一步下載的 sdk 資料夾裡
D:\adt-bundle-windows-x86_64-20131030\sdk
然後在 platform-tools 資料夾上按住 Shift 鍵,然後再按滑鼠右鍵
選擇"在此處開啟命令視窗"
(此功能只有 Win7 之後的版本才支援, XP使用者就要自行輸入 dos 指令進入到資料夾)
輸入 adb devices
如果看到一串數字,並顯示 device 就表示連線成功
5.新增環境變數(選擇性設定)
為了方便的使用 adb 指令
可以為 windows 設定變數
開啟我的電腦 / 內容 / 左邊的"進階系統設定"
點選下方 環境變數

下方系統變數,找到 Path的選項,按下編輯

在變數值欄位的最後方加入
;D:\adt-b…