雪碧图工具sprity(20151201更新修复了同时合并多张图的bug)

rayliao

前身是css-sprite,前几天帮新同事搭建环境,意外发现sprity在window下可以安装成功了,同时也发现node版本已经4点几了,自己电脑的版本还停留在0.10,赶紧把自己的node升级到最新版本,win10下,sprity安装成功,可以使用。

在这里介绍下sprity顺便提下自己遇到的问题。

介绍

sprity,一个模块化的雪碧图生成工具,会根据目录中的图片生成相应的雪碧图和样式文件,支持retina图,可以内嵌base64 编码格式的图,支持不同的图片格式和有不同的图片引擎可以选择。

安装使用

通过npm安装

npm install sprity --save

也可以全局安装使用

npm install sprity -g

结合gulp使用,也可以用grunt,这里说下gulp的用法:

var gulp = require('gulp');
var gulpif = require('gulp-if');
var sprity = require('sprity');

// 创建sprites任务
gulp.task('sprites', function () {
  return sprity.src({
    src: './src/images/**/*.{png,jpg}', //需要进行合并的图片路径
    style: './sprite.css',              //生成的样式文件名和格式,可以生成scss
    // 还有很多其他参数,如指定模板、图片格式、前缀、名称和图片合并的方向等,具体可以查看sprity的github内容
    processor: 'sass', // 生成的样式格式
  })
  .pipe(gulpif('*.png', gulp.dest('./dist/img/'), gulp.dest('./dist/css/')))
});

配置好options,把图片放进目录中,运行gulp sprites,就可以生成对应的雪碧图和样式文件了。

sprity支持三种图片引擎,sprity-lwip、sprity-canvas和sprity-gm。默认使用的是sprity-lwip,好像lwip需要重新编译node-gyp什么的,所以当时我还是win7系统的时候,经常会报错,无法编译成功。另两个没试过,不展开说,有兴趣的可以去试着使用下。

模板

sprity采用handlebar来处理模板,已经写好有模板案例可以参考,sprity-css

图片引擎

鉴于sprity-lwip在windows下很难部署,太难安装成功了。所以我尝试了其他的引擎,sprity-canvas也很难安装成功,最后唯有靠sprity-gm了,这个需要依靠GraphicsMagick和Imagemagick,我尝试只安装其中某一个,发现不行,一定得两个都安装。

自己搜索引擎找到官网下载,然后安装,重启电脑,对,要重启才有用,不然会报错。

接着安装sprity-gm

npm install sprity-gm

然后在gulp的任务中加上参数配置:

engine: 'gm',
format: 'png', // because sprity name it with uppercase: https://github.com/sprity/sprity/issues/28
'gm-use-imagemagick': true

就可以了。

问题

使用途中,我遇到一个问题无法解决,一个gulp任务里面,我想同时分开生成多张雪碧图,不知道为什么生成的图和样式会合并在一起。

例如,我这样写:

gulp.task('sprites', function () {
    sprity.src({
        src: '/img/icon/*.png',
        style: '_icon.scss',
        format: 'png',
        orientation: 'left-right',
        template: './sprity-css.hbs',
        processor: 'scss',
        prefix: 'icon',
        name: 'icon'
    })
    .pipe(gulpif('*.png', gulp.dest('/img/'), gulp.dest('/css/')));

    sprity.src({
        src: topicType + '/img/bg/*.png',
        style: '_bg.scss',
        format: 'png',
        orientation: 'left-right',
        template: './sprity-css.hbs',
        processor: 'scss',
        prefix: 'bg',
        name: 'bg'
    })
    .pipe(gulpif('*.png', gulp.dest('/img/'), gulp.dest('/css/')));
});

最后生成两张图片:icon.png和bg.png,两个样式文件:_bg.scss和_icon.scss,这样没错,可以icon的图片和样式里面包含有bg的图片和样式:

_icon.scss:

.bg {
      background-image: url('#{$icon-sprite-path}/bg.png');
    }

  .bg-btn-tg {
    background-position: -526px -196px;
    width: 80px;
    height: 32px;
  }
.icon {
      background-image: url('#{$icon-sprite-path}/icon.png');
    }

  .icon-btn-tg {
    background-position: -510px -280px;
    width: 80px;
    height: 32px;
  }

_bg.scss:

.bg {
      background-image: url('#{$icon-sprite-path}/bg.png');
    }

  .bg-btn-tg {
    background-position: -526px -196px;
    width: 80px;
    height: 32px;
  }

我不确定是gulp流的问题,还是模板的问题,因为模板循环的是一个数组来的。
sprity-css.hbs:

{{#each layouts}}
  {{#each sprites}}

    {{#if dpi}}
    @media (-webkit-min-device-pixel-ratio: {{ratio}}), (min-resolution: {{dpi}}dpi) {
    {{/if}}
    .{{cssesc ../classname}} {
      background-image: url('{{escimage url}}');
      {{#if dpi}}
      background-size: {{baseWidth}}px {{baseHeight}}px;
      {{/if}}
    }
    {{#if dpi}}
    }
    {{/if}}
  {{/each}}

  {{#each layout.items}}
  .{{../classname}}-{{meta.name}} {
    background-position: -{{baseDim x}}px -{{baseDim y}}px;
    width: {{baseDim width}}px;
    height: {{baseDim height}}px;
  }
  {{/each}}
{{/each}}

20151201更新
sprity修复了同时合并多张图片会重叠的bug,当时也想过试下能不能修改,然技术太渣,不知道哪里修改。
原因好像是sprity会从同一个节点处理多个png流,以致默认的layout成为包罗万象的每一个png图像,英语太渣。
其实就是把一个变量改下就可以了。现在可以同时合并多张图片了。
修复问题的commit


20160227更新
新的sprity-css.hbs:

{{#each layouts}}
  {{#each layout.items}}
  ${{meta.name}}: -{{x}}px -{{y}}px {{meta.width}}px {{meta.height}}px;
  {{/each}}

  @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) - 4;
  $sprite-offset-y: nth($sprite, 2) - 4;
  background-position: $sprite-offset-x $sprite-offset-y;
  }

  {{#each sprites}}
  @mixin sprite-{{name}}() {
  background-image: url('#{$icon-sprite-path}/{{name}}.png?v=#{$version}');
  }
  {{/each}}

  @mixin sprite($sprite) {
  @include sprite-position($sprite);

  @include sprite-width($sprite);
  @include sprite-height($sprite);

  }

  {{#each sprites}}
  .{{name}} {
    background-repeat: no-repeat;
    overflow: hidden;
    border: none;
    background: url('#{$icon-sprite-path}/{{name}}.png?v=#{$version}');
    @include inline-block();
    vertical-align: middle;
    font-style: normal;
  }
  {{/each}}

  {{#each layout.items}}
  .{{meta.name}} {
    @include sprite(${{meta.name}});
  }
  {{/each}}
{{/each}}
阅读 6.6k

以梦为码
以梦为码

前端渣滓

3.1k 声望
48 粉丝
0 条评论

前端渣滓

3.1k 声望
48 粉丝
文章目录
宣传栏