webpack踩坑之路圖片的路徑與打包
剛開始用webpack的同學(xué)很容易掉進(jìn)圖片打包這個坑里,比如打包出來的圖片地址不對或者有的圖片并不能打包進(jìn)我們的目標(biāo)文件夾里(bundle)。下面我們就來分析下在webpack項目中圖片的應(yīng)用場景。
在實際生產(chǎn)中有以下幾種圖片的引用方式:
1. HTML文件中img標(biāo)簽的src屬性引用或者內(nèi)嵌樣式引用
<img src="photo.jpg" /> <div style="background:url(photo.jpg)"></div>
2. CSS文件中的背景圖等設(shè)置
.photo {
background: url(photo.jpg);
}
3. JavaScript文件中動態(tài)添加或者改變的圖片引用
var imgTempl = '<img src="photo.jpg" />'; document.body.innerHTML = imgTempl;
4. ReactJS中圖片的引用
import React from 'react';
import ReactDOM from 'react-dom';
class App extends React.Component {
render() {
return (<img src='photo.jpg' />);
}
}
ReactDom.render(<App />, document.querySelector('#container'));
url-loader
在 webpack 中引入圖片需要依賴 url-loader 這個加載器。
安裝:
npm install url-loader --save-dev
當(dāng)然你可以將其寫入配置中,以后與其他工具模塊一起安裝。
在 webpack.config.js 文件中配置如下:
module: {
loaders: [
{
test: /\.(png|jpg)$/,
loader: 'url-loader?limit=8192'
}
]
}
test 屬性代表可以匹配的圖片類型,除了 png、jpg 之外也可以添加 gif 等,以豎線隔開即開。
loader 后面 limit 字段代表圖片打包限制,這個限制并不是說超過了就不能打包,而是指當(dāng)圖片大小小于限制時會自動轉(zhuǎn)成 base64 碼引用。上例中大于8192字節(jié)的圖片正常打包,小于8192字節(jié)的圖片以 base64 的方式引用。
url-loader 后面除了 limit 字段,還可以通過 name 字段來指定圖片打包的目錄與文件名:
module: {
loaders: [
{
test: /\.(png|jpg)$/,
loader: 'url-loader?limit=8192&name=images/[hash:8].[name].[ext]'
}
]
}
上例中的 name 字段指定了在打包根目錄(output.path)下生成名為 images 的文件夾,并在原圖片名前加上8位 hash 值。
例:工程目錄如下

在 main.css 中引用了同級 images 文件夾下的 bg.jpg 圖片
background-image: url(./images/bg.jpg);
通過之前的配置,使用 $ webpack 命令對代碼進(jìn)行打包后生成如下目錄

打包目錄中,css 文件和 images 文件夾保持了同樣的層級,可以不做任務(wù)修改即能訪問到圖片。區(qū)別是打包后的圖片加了 hash 值,bundle.css 文件里引入的也是有hash值的圖片。
background-image: url(images/f593fbb9.bg.jpg);
(上例中,使用了單獨打包css的技術(shù),只是為了方便演示)
publicPath
output.publicPath 表示資源的發(fā)布地址,當(dāng)配置過該屬性后,打包文件中所有通過相對路徑引用的資源都會被配置的路徑所替換。
output: {
path: 'dist',
publicPath: '/assets/',
filename: 'bundle.js'
}
main.css
background-image: url(./images/bg.jpg);
bundle.css
background-image: url(/assets/images/f593fbb9.bg.jpg);
該屬性的好處在于當(dāng)你配置了圖片 CDN 的地址,本地開發(fā)時引用本地的圖片資源,上線打包時就將資源全部指向 CDN 了。
但是要注意,如果沒有確定的發(fā)布地址不建議配置該屬性,否則會讓你打包后的資源路徑很混亂。
JS中的圖片
初用 webpack 進(jìn)行項目開發(fā)的同學(xué)會發(fā)現(xiàn):在 js 或者 react 中引用的圖片都沒有打包進(jìn) bundle 文件夾中。
正確寫法應(yīng)該是通過模塊化的方式引用圖片路徑,這樣引用的圖片就可以成功打包進(jìn) bundle 文件夾里了
js
var imgUrl = require('./images/bg.jpg'),
imgTempl = '<img src="'+imgUrl+'" />';
document.body.innerHTML = imgTempl;
react
render() {
return (<img src={require('./images/bg.jpg')} />);
}
HTML中的圖片
由于 webpack 對 html 的處理不太好,打包 HTML 文件中的圖片資源是相對來說最麻煩的。這里需要引用一個插件—— html-withimg-loder
$ npm install html-withimg-loader --save-dev
webpack.config.js 添加配置
module: {
loaders: [
{
test: /\.html$/,
loader: 'html-withimg-loader'
}
]
}
在 bundle.js 中引用 html 文件
import '../index.html';
這樣 html 文件中的圖片就可以被打包進(jìn) bundle 文件夾里了。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
微信小程序天氣預(yù)報功能實現(xiàn)(支持自動定位,附源碼)
對于一個經(jīng)常出門在外的人,關(guān)注天氣是至關(guān)重要的,下面這篇文章主要給大家介紹了關(guān)于微信小程序天氣預(yù)報功能實現(xiàn)的相關(guān)資料,文中通過實例代碼介紹的非常詳細(xì),支持自動定位,需要的朋友可以參考下2022-04-04
JavaScript中Location.search處理使用方法
本文主要介紹了JavaScript中Location.search處理使用方法,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-04-04

