CSS Sprite(雪碧圖)將多張小圖標合併為一張大圖,通過 background-position 定位顯示,減少 HTTP 請求,提升頁面加載性能。
@mixin、變量、類名映射npm install gulp gulp-if sprity --save-dev
const gulp = require('gulp');
const gulpif = require('gulp-if');
const sprity = require('sprity');
gulp.task('sprites', function () {
return sprity.src({
src: 'src/assets/icons/*.png', // 源圖標目錄
style: '_sprite.scss', // 輸出樣式文件
processor: 'scss', // 處理器
name: 'sprite', // 雪碧圖基礎名
format: 'png', // 輸出格式
orientation: 'binary-tree', // 打包算法:binary-tree/left-right/top-down
margin: 4, // 圖標間距
split: true, // 按目錄分組生成多張雪碧圖
template: './sprite-tpl.mustache', // 自定義模板
cssPath: '../images/sprite.png' // CSS 中引用路徑
})
.pipe(gulpif('*.png', gulp.dest('dist/images/'), gulp.dest('dist/styles/')));
});
{{#items}}
$icon-{{name}}: {{px.offset_x}} {{px.offset_y}} {{px.width}} {{px.height}};
{{/items}}
@mixin sprite-width($sprite) { width: nth($sprite, 3); }
@mixin sprite-height($sprite) { height: nth($sprite, 4); }
@mixin sprite-position($sprite) {
$x: nth($sprite, 1); $y: nth($sprite, 2);
background-position: $x $y;
}
@mixin sprite($sprite) {
@include sprite-position($sprite);
@include sprite-width($sprite);
@include sprite-height($sprite);
}
{{#sprite}}
.icon {
display: inline-block;
background: url('{{{escaped_image}}}?v={{version}}') no-repeat;
vertical-align: middle;
overflow: hidden;
text-indent: -9999px; /* 文字隱藏 */
}
{{/sprite}}
{{#items}}
.icon-{{name}} { @include sprite($icon-{{name}}); }
{{/items}}
$icon-home: -10px -10px 24px 24px;
$icon-user: -44px -10px 24px 24px;
$icon-setting: -78px -10px 24px 24px;
.icon {
display: inline-block;
background: url('../images/sprite.png?v=1.0.0') no-repeat;
vertical-align: middle;
overflow: hidden;
}
.icon-home { @include sprite($icon-home); }
.icon-user { @include sprite($icon-user); }
.icon-setting { @include sprite($icon-setting); }
<i class="icon icon-home" aria-label="首頁"></i>
<button class="btn"><i class="icon icon-user"></i> 個人中心</button>
@2x 圖標,配置 ratio: 2 生成雙倍圖 + Media Querysvg-sprite 或 svgr,矢量無損、內聯可控制顏色gulp.watch('src/assets/icons/**/*.png', gulp.series('sprites')) 實時生成?v={{version}} 關聯 package.json 版本,自動緩存更新sprity 依賴 lwip(需 node-gyp 編譯 C++ 插件),Windows 易失敗。解決:
npm install --global windows-build-toolssharp 替代 lwip 的分支版本webpack-spritesmith / postcss-sprites 純 JS 實現