grunt前端开发插件grunt-sprite

这是什么

grunt-sprite 是一个 grunt 的前端开发插件。

能干什么

这是一个帮助前端开发工程师将css代码中的切片合并成雪碧图的工具,它的主要功能是:

  1. 使用二叉树排列算法,对css文件进行处理,收集切片序列,生成雪碧图
  2. 在原css代码中为切片添加background-position属性
  3. 生成用于高清设备的高清雪碧图,并在css文件末尾追加媒体查询代码
  4. 在引用雪碧图的位置打上时间戳
  5. 在样式末尾追加时间戳

安装依赖

grunt-sprite 使用 spritesmith 作为内部核心算法,根据官方文档中提到的基本依赖,须要安装Graphics Magick(gm) 和 PhantomJS 两个依赖。

  • Graphics Magick(gm)

    GraphicsMagick 为 grunt-sprite 提供用于图像处理的框架,安装方法:

  • PhantomJS

    PhantomJS 为 spritesmith 提供 CSS选择器 与 JSON 的支持,安装方法:

配置说明

// 自动雪碧图
  sprite: {
      allslice: {
          files: [
              {
                  //启用动态扩展
                  expand: true,
                  // css文件源的文件夹
                  cwd: 'css',
                  // 匹配规则
                  src: ['*.css'],
                  //导出css和sprite的路径地址
                  dest: 'tmp/',
                  // 导出的css名
                  ext: '.sprite.css'
              }
          ],
          options: {
              // 默认使用GM图像处理引擎
              'engine': 'gm',
              // 默认使用二叉树最优排列算法
              'algorithm': 'binary-tree',
              // 默认给雪碧图追加时间戳
              'imagestamp':true,
              // 默认给样式文件追加时间戳
              'cssstamp':true

          }
      }
  }
  • files

    使用标准的动态文件对象

    dest 指定一个输出的目录,将会在这个目录下创建一个css/和一个sprite/目录。

  • options

    • engine

      必选项,指定图像处理引擎,选择gm

    • algorithm

      必选项,指定排列方式,有top-down (从上至下), left-right(从左至右), diagonal(从左上至右下), alt-diagonal (从左下至右上)和 binary-tree(二叉树排列) 五种供选择。

    • imagestamp

      可选项,是否要给雪碧图追加时间戳

    • cssstamp

      可选项,是否给样式文件追加时间戳

载入插件

请不要忘了载入插件

grunt.loadNpmTasks('grunt-sprite'); 

打个比方

有一个类似这样的目录结构:

    ├── test                
        ├── css/    
            └── icon.css        
        ├── slice/  
                ├── icon-a.png
                ├── icon-a@2x.png       
                ├── icon-b.png
                └── icon-b@2x.png
        └── publish
            ├── css/
                └── icon.sprite.css
            └── sprite/     
                └── icon.png

css/icon.css 调用slice/目录下的切片,grunt-sprite 会将 css/icon.css 处理。

publish/ 目录下生成 css/ 和 sprite/ 两个目录,css/ 目录下是处理完成的样式icon.sprite.css ,而 sprite/ 目录下是合并完成的雪碧图 icon.png

特别注意

  1. css文件置于css/文件夹中,切片文件置于slice/文件夹中,且 css/slice/ 处于同级。
  2. css/ 和 slice/ 目录不一定要处于项目根目录
  3. 理论上所有的切片都应该是.png格式,png8 png24 和 png32不限
  4. 理论上高清切片都应该是源切片尺寸的2倍,所以所有高清切片的尺寸宽和高都必须是偶数
  5. 生成后的雪碧图将以源css文件名来命名

源码

grunt-sprite的前身是grunt-hellosprite,为了方便好记,已全部迁移到grunt-sprite

如果你对本项目感兴趣,可以在github上查看项目

延伸阅读


▶ Walkthrough007

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值