原 css-sprite 已停更,現改名 sprity,功能更豐富。安裝最大坑點在 lwip 依賴需 node-gyp 編譯,Windows 環境極易失敗(Mac 較順)。團隊若遇安裝困難,可嘗試預編譯方案或替代工具。
var gulp = require('gulp');
var gulpif = require('gulp-if');
var sprity = require('sprity'); // 原 css-sprite
gulp.task('sprites', function() {
return gulp.src('img/icon/*.png') // 來源圖片
.pipe(sprity({
name: 'icon', // 輸出檔名前綴
style: '_icon.scss', // 樣式輸出檔
format: 'png',
orientation: 'left-right', // 排列方向:水平/垂直/對角
cssPath: '#{$icon-sprite-path}', // CSS 內圖片路徑變數
template: './sprite-tpl.mustache', // Mustache 模板
processor: 'scss' // 輸出格式
}))
.pipe(gulpif('*.png', gulp.dest('img/'), gulp.dest('css/')));
});
{{#items}}
${{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) {
$sprite-offset-x: nth($sprite, 1);
$sprite-offset-y: nth($sprite, 2);
background-position: $sprite-offset-x $sprite-offset-y;
}
@mixin sprite($sprite) {
@include sprite-position($sprite);
@include sprite-width($sprite);
@include sprite-height($sprite);
}
{{#sprite}}
.{{class}} {
background-repeat: no-repeat;
overflow: hidden;
border: none;
background: url('{{{escaped_image}}}?v=#{$version}');
@include inline-block();
vertical-align: middle;
font-style: normal;
color: $icon-font-color;
}
{{/sprite}}
{{#items}}
.{{name}} { @include sprite(${{name}}); }
{{/items}}
$icon-qq: -262px -161px 60px 60px;
$icon-email: -332px -161px 60px 60px;
$icon-skype: -5px -252px 60px 60px;
$icon-phone: -75px -252px 60px 60px;
.icon {
background-repeat: no-repeat;
overflow: hidden;
border: none;
background: url('#{$icon-sprite-path}/icon.png?v=#{$version}');
@include inline-block();
vertical-align: middle;
font-style: normal;
color: $icon-font-color;
}
.icon-qq { @include sprite($icon-qq); }
.icon-email { @include sprite($icon-email); }
.icon-skype { @include sprite($icon-skype); }
.icon-phone { @include sprite($icon-phone); }
HTML 僅需 class="icon icon-qq" 即可顯示對應圖示。新增圖片丟入 img/icon/,執行 gulp sprites 自動重建,搭配 gulp.watch 可達即時生成。
遷移至 sprity 設定大同小異,新增功能有機會再介紹。Windows 安裝若持續失敗,歡迎分享解法。