Webpack中雪碧圖插件使用詳解
背景
在開發(fā)過程中,我們需要用到很多圖標(biāo),這些圖標(biāo)的大小不是很大,但是每次需要向服務(wù)器發(fā)送請(qǐng)求,從而加重服務(wù)器的負(fù)擔(dān),尤其是當(dāng)網(wǎng)站處于高訪問量的情況下或網(wǎng)絡(luò)不穩(wěn)定的時(shí)候,服務(wù)器性能會(huì)明顯下降。這種情況不符合被廣泛遵循的雅虎軍規(guī)“盡量減少HTTP請(qǐng)求數(shù)”的要求(雅虎前端優(yōu)化的35條軍規(guī))。
為了避免這種情況,我們需要使用到雪碧圖將這些圖標(biāo)整合到一張圖片上,再使用CSS背景及其定位,將需要顯示的圖標(biāo)移動(dòng)到元素背景中。
傳統(tǒng)方式,我們需要將圖標(biāo)拼接到一張圖片上,計(jì)算好位置信息,這種方式維護(hù)起來比較麻煩。自從有了打包工具grunt、gulp和webpack之后,這一切似乎容易了許多。這里我重點(diǎn)介紹webpack雪碧圖插件webpack-spritesmith的使用。
雪碧圖插件 webpack-spritesmith 詳解
本人是在 vue-cli 中增加了該雪碧圖插件,關(guān)鍵步驟如下,細(xì)節(jié)上以 vue-cli 為背景,其他框架類似配置。
1. 安裝配置
首先在項(xiàng)目中按照官方說明 install 之后,在 bulid/webpack.base.conf.js 中進(jìn)行如下配置。需要說明的是,雪碧圖是開發(fā)模式和生產(chǎn)模式都要使用的功能,因此我們?cè)?webpack 的基礎(chǔ)配置中進(jìn)行設(shè)置。
1.1 首先引入插件 const SpritesmithPlugin = require('webpack-spritesmith');;
1.2 其次在 module.rules 將 png 圖標(biāo)的默認(rèn)配置注釋掉,避免 url-loader 將其編譯成行內(nèi)圖片,同時(shí)單獨(dú)設(shè)置 png 圖標(biāo)的配置,如下:
{
// test: /\.(png|jpe?g|gif|svg)(\?.*)?$/, // 注釋掉原有配置,去掉對(duì)png圖標(biāo)的匹配
test: /\.(jpe?g|gif|svg)(\?.*)?$/,
loader: 'url-loader',
options: {
limit: 10000,
name: utils.assetsPath('img/[name].[hash:7].[ext]')
}
},
// 對(duì)圖標(biāo)單獨(dú)設(shè)置,以便生成雪碧圖
{
test: /\.png$/,
loaders: [
'file-loader' // 使用 file-loader 對(duì) png 圖標(biāo)進(jìn)行設(shè)置
]
},
1.3 接著在 webpack 的配置對(duì)象中找到 plugins 屬性(沒有請(qǐng)自行創(chuàng)建),添加雪碧圖的處理。基本配置如下:
plugins: [
// 雪碧圖設(shè)置
new SpritesmithPlugin({
src: {
cwd: path.resolve(__dirname, '../src/assets/images/icons/'), // 圖標(biāo)根路徑
glob: '**/*.png' // 匹配任意 png 圖標(biāo)
},
target: {
image: path.resolve(__dirname, '../src/assets/css/sprites-generated.png'), // 生成雪碧圖目標(biāo)路徑與名稱
// 設(shè)置生成CSS背景及其定位的文件或方式
css: [
[path.resolve(__dirname, '../src/assets/css/sprites-generated.css'), {
format: 'function_based_template'
}]
]
// css: path.resolve(__dirname, '../src/assets/spritesmith-generated/sprite.less')
},
customTemplates: {
'function_based_template': templateFunction,
},
apiOptions: {
cssImageRef: "./sprites-generated.png", // css文件中引用雪碧圖的相對(duì)位置路徑配置
},
})
],
這里我使用的是CSS定制方式,即在 target.css 中,配置對(duì)應(yīng)的format函數(shù)名 function_based_template(注意數(shù)組元素的層次關(guān)系,切勿配錯(cuò))。然后在 customTemplates 中配置對(duì)應(yīng)名稱的屬性名。
這里我引用了自定義函數(shù) templateFunction,該函數(shù)基本參考了官方示例。由于本人使用的是二倍圖,所以此處使用了圖片縮放和垂直居中的方式。大家選擇參考:
const templateFunction = function (data) {
// console.log(data.sprites);
const shared = '.w-icon { background-image: url(I); }'
.replace('I', data.sprites[0].image);
// 注意:此處默認(rèn)圖標(biāo)使用的是二倍圖
const perSprite = data.sprites.map(function (sprite) {
// background-size: SWpx SHpx;
return '.w-icon-N { width: SWpx; height: SHpx; }\n.w-icon-N .w-icon, .w-icon-N.w-icon { width: Wpx; height: Hpx; background-position: Xpx Ypx; margin-top: -SHpx; margin-left: -SWpx; } '
.replace(/N/g, sprite.name)
.replace(/SW/g, sprite.width / 2)
.replace(/SH/g, sprite.height / 2)
.replace(/W/g, sprite.width)
.replace(/H/g, sprite.height)
.replace(/X/g, sprite.offset_x)
.replace(/Y/g, sprite.offset_y);
}).join('\n');
return shared + '\n' + perSprite;
};
其實(shí)關(guān)鍵之處就是利用定制函數(shù),將參數(shù)中每個(gè)圖標(biāo)的信息用來進(jìn)行樣式的定制。這些信息中包括圖標(biāo)名、寬高和在雪碧圖中的位置信息等。
當(dāng)然我們也可以將目標(biāo)生成成 less 文件,然后再進(jìn)行使用(示例代碼中注釋部分)。但本人發(fā)現(xiàn)會(huì)生成大量變量,而這些變量我們并不經(jīng)常使用,所以本人沒有采用這種方式。
2. 使用方法
進(jìn)行完上述配置之后,再在我們配置的源文件夾中添加我們需要處理的圖標(biāo)。然后啟動(dòng) vue-cli 的開發(fā)者模式 npm run start(其他框架,運(yùn)行對(duì)應(yīng)命令)。
啟動(dòng)完成之后,我們可以發(fā)現(xiàn)在目標(biāo)目錄下生成了 sprites-generated.png 和 sprites-generated.css 兩個(gè)文件。在樣式文件中,形如:
.w-icon { background-image: url(./sprites-generated.png); }
.w-icon-apply { width: 25.5px; height: 27px; }
.w-icon-apply .w-icon, .w-icon-apply.w-icon { width: 51px; height: 54px; background-position: -208px -58px; margin-top: -27px; margin-left: -25.5px; }
接下來就是在使用組件中引用上述樣式即可。
3.遇到的問題
3.1 放大頁(yè)面時(shí),有些雪碧圖標(biāo)邊緣出現(xiàn)相鄰圖標(biāo)的邊緣,從而出現(xiàn)白線,怎么破?
做完雪碧圖之后,高高興興的拿給UI參看一下,沒過多久就被鄙視了:怎么頁(yè)面放大時(shí),旁邊有一條白線?
納尼?怎么可能??!仔細(xì)一看,放大之后有些圖標(biāo)周邊出現(xiàn)一些線條,而有些圖標(biāo)則沒有。而不放大時(shí),則沒有這種情況。
難道是其他圖表也顯示進(jìn)來了?再回去看看生成的雪碧圖,果然是一個(gè)圖標(biāo)一個(gè)圖標(biāo)的緊緊的靠在一起,即圖標(biāo)之間沒有空隙。而且有些圖標(biāo)計(jì)算的結(jié)果有 .5px ,我們知道有些瀏覽器會(huì)解析成1px,從而出現(xiàn)上述問題,瞬間恍然大悟。
于是仔細(xì)翻閱官方說明,其中提到核心組件是 spritesmith and spritesheet-templates ,于是進(jìn)入 spritesmith 插件中查閱,發(fā)現(xiàn)果然有關(guān)于邊距問題的描述和解決方法 spritesmith: padding。
可是在 webpack-spritesmith 又該怎么使用呢?
查閱 webpack-spritesmith 源代碼和文檔,發(fā)現(xiàn):spritesmithOptions - optional. Options for spritesmith
好的,就是你啦!然后在 webpack 配置文件中,增加 padding 屬性,這里單位為 px:
plugins: [
// 雪碧圖設(shè)置
new SpritesmithPlugin({
// ... 省略其他配置
// 核心組件配置
spritesmithOptions: {
padding: 4,
}
})
],
重新啟動(dòng)項(xiàng)目編譯,打開雪碧圖和樣式,發(fā)現(xiàn)圖標(biāo)之間有間隙了,且放大頁(yè)面后,圖標(biāo)邊緣也沒有出現(xiàn)白線問題。好了,搞定!
總結(jié)
有了這個(gè)插件之后,我們就可以在配置目錄下動(dòng)態(tài)添加圖標(biāo),此時(shí)webpack 會(huì)立即重新編譯生成新的雪碧圖和對(duì)應(yīng)樣式,這樣我們就可以在頁(yè)面上立刻使用對(duì)應(yīng)圖標(biāo),再也不用擔(dān)心自己設(shè)置的 background-position 有不對(duì)的地方了。好了,Have Fun!
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
淺談javascript的Array.prototype.slice.call
發(fā)現(xiàn)大多人都用了Array.prototype.slice.call(argments,0),一直不明白這句是干什么的。而昨天溫習(xí)了slice()方法,再參考Function.call(thisArg[, arg1[, arg2[, ...]]]),還是不得而知(我腦筋轉(zhuǎn)得慢:|)。2015-08-08
詳解微信小程序動(dòng)畫Animation執(zhí)行過程
這篇文章主要介紹了微信小程序動(dòng)畫Animation執(zhí)行過程 / 實(shí)現(xiàn)過程 / 實(shí)現(xiàn)方式,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-09-09
Electron 打包問題:electron-builder 下載各種依賴出錯(cuò)(推薦)
這篇文章主要介紹了Electron 打包問題:electron-builder 下載各種依賴出錯(cuò),本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-07-07
談?wù)剬?duì)JavaScript原生拖放的深入理解
拖放(drag-and-drop,DnD)其實(shí)是兩個(gè)動(dòng)作——拖和放。所以,它涉及到兩個(gè)元素。一個(gè)是被拖的元素,稱為拖放源;另一個(gè)是要放的目標(biāo),稱為拖放目標(biāo)。本文將通過拆分這兩個(gè)概念來詳細(xì)介紹原生拖放,感興趣的朋友一起學(xué)習(xí)吧2016-09-09
兩個(gè)listbox實(shí)現(xiàn)選項(xiàng)的添加刪除和搜索
listbox竟然可以實(shí)現(xiàn)選項(xiàng)的添加刪除和搜索不可思議吧,至于采用什么樣的方法實(shí)現(xiàn)的,具體代碼祥看本文嘍,或許可以幫助到你2013-03-03
javascript動(dòng)態(tài)控制服務(wù)器控件實(shí)例
在頁(yè)面中放入一個(gè)DropDownList控件,并添加一項(xiàng),用來分析其產(chǎn)生的HTML代碼,這樣在使用js進(jìn)行動(dòng)態(tài)控制時(shí),將會(huì)非常清晰2014-09-09

