這大概是我用過最好用的雪碧圖工具了——好吧,至少是其中之一。
先說安裝 css-sprite,這一步有點坑,我放到最後再講。
安裝命令:
npm install css-sprite
我用 gulp 來構建前端代碼,所以還需要安裝 gulp 和 gulp-if,裝好後就能開始配置了。
新建一個 task:
var gulp = require('gulp');
var gulpif = require('gulp-if');
gulp.task('sprites',function(){
gulp.src('img/icon/*.png') // 這是要合併的圖片路徑
.pipe(sprite({
name: 'icon', // 定義一個名稱
style: '_icon.scss', // 生成的樣式文件
format: 'png', // png 格式的圖片
orientation: 'left-right', // 雪碧圖合併方向,也可設為垂直或水平
cssPath: '#{$icon-sprite-path}', // 雪碧圖路徑變量
template: './sprite-tpl.mustache', // scss 生成模板
processor: 'scss' // 生成樣式文件的格式
}))
.pipe(gulpif('*.png', gulp.dest('img/'), gulp.dest('css/')));
});
scss 模板使用 mustache:
{{#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 文件夾,運行 gulp sprites,就能生成一張雪碧圖 icon.png 和對應的 scss 樣式文件 _icon.scss。你也可以再建一個監聽任務,實時監控 icon 文件夾,做到實時生成。
下面貼出生成的 _icon.scss:
$icon-qq: -262px -161px 60px 60px;
$icon-email: -332px -161px 60px 60px;
$icon-skype: -5px -252px 60px 60px;
$icon-phone: -75px -252px 60px 60px;
@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);
}
.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);
}
使用時只需加上類似 class="icon icon-qq" 的寫法即可。
作者如今已不再更新 css-sprite 了,現在它叫 sprity,配置大同小異,sprity 還多了些功能,以後有機會再介紹。
現在說說開頭提到的坑——安裝問題。微軟環境下很難裝成功,因為它依賴 lwip,需要 node-gyp 重新編譯。我自己電腦裝好了,但有些同事怎麼配都裝不上。Mac 下我還沒試過,估計沒問題,Windows 環境比較折騰。如果你們也遇到安裝問題並且成功解決了,歡迎告訴我。:)