DeveWork

postcss-lazysprite: 一种生成CSS 雪碧图的懒惰姿势

postcss-lazysprite 是一个基于PostCSS 开发的用于生成雪碧图图片及其CSS 的插件,经过半年持续迭代,现已稳定用在旗下两款产品的Web 业务中。其与市面上的雪碧图插件不同在于生成雪碧图的“懒惰”姿势。

前言

前端界,伴随着雪碧图这个概念出现,自动化产生雪碧图这类工具就层出不穷。无论是早期GUI 工具,还是现在流行的配合Gulp/Grunt/Webpack 这类构建工具而产生的雪碧图插件。总之是百花齐放,长江后浪推前浪,后浪死在沙滩上

根据输入方式的不同,现在市面上基于Node.js 的雪碧图构建工具一般可分为如下两种(如有不实,望予以指出):

一种是现在国外常见的基于spritesmith 的各类通过构建工具注册任务进行合并产生雪碧图的插件,如gulp-sprite、css-sprite、sprity 等。

// 本段代码来自sprity 的sample
gulp.task('sprites', function () {
  return sprity.src({
    src: './src/images/**/*.{png,jpg}',
    style: './sprite.css',
    processor: 'sass',
  })
  .pipe(gulpif('*.png', gulp.dest('./dist/img/'), gulp.dest('./dist/css/')))
});

另一种是国内以cssgaga、gulp-tmtsprite 为代表的,在开发阶段是写单个小图的CSS 样式,然后也是通过构建工具的注册任务进行合并产生雪碧图的插件。

// 本段代码来自gulp-tmtsprite 的sample
// Input
.icon-test {
    width: 32px;
    height: 32px;
    background-image: url(../slice/test.png);
}

// Output
.icon-test {
    background-image: url(../sprite/style-index.png);
}
 
@media only screen and (-webkit-min-device-pixel-ratio: 2), 
only screen and (min--moz-device-pixel-ratio: 2), 
only screen and (-webkit-min-device-pixel-ratio: 2.5), 
only screen and (min-resolution: 240dpi) {
.icon-test { 
    background-image:url("../sprite/style-index@2x.png");
    background-position: -36px -66px;
    background-size: 32px;
}
}

对比与不同

各类工具本身有其合理存在的理由与最适合的使用场景,去褒贬来衬托我这个插件并不是本文的目的。如上面介绍的两种类型的插件,一种是将雪碧图合成从常规的写CSS 行为中抽离出来,一种是后编译的雪碧图合成,其使用场景各不相同。本文介绍的postcss-lazysprite,在于解决的场景是:我想在开发阶段就生成雪碧图并用上其CSS,同时我又想很方便地产生,用起来越简单越好。所谓lazysprite,就是期许一种“懒惰”的方式去生成雪碧图。

postcss-lazysprite 用起来就是那么简单,经过配置后,你只需要这样写:

/* ./src/css/index.css */
@lazysprite "filetype";

输出的自然是完整的雪碧图以及相应CSS:

/* ./dist/css/index.css */
.icon-filetype-doc {
    background-image: url(../sprites/filetype.3f1f178013.png);
    background-position: 0 0;
    width: 80px;
    height: 80px;
}

@media only screen and (-webkit-min-device-pixel-ratio: 2), only screen and (min--moz-device-pixel-ratio:2), only screen and (-o-min-device-pixel-ratio:2/1), only screen and (min-device-pixel-ratio:2), only screen and (min-resolution:2dppx), only screen and (min-resolution:192dpi) {
    .icon-filetype-doc {
        background-image: url(../sprites/filetype@2x.cbed5ca6a9.png);
        background-position: 0 0;
        background-size: 170px 170px;
    }
}

假设后面要新增图片到filetype 文件夹,那么直接丢进去就能自动重新合并并更新CSS;如果要新建一个与filetype 同级的文件夹(如logos),那么在需要的位置@lazysprite "logos";即可。一切就是那么简单,所谓lazy,即是如此。

如果你有用过Sass 框架Compass 的话,你会觉得跟Compass 的雪碧图产生方式是如此类似。是的,这个插件就是沿用了Compass 的雪碧图思路,甚至这个插件的的底层就是spritesmith 驱动的,而我在写这个插件的时候参考了postcss-sprite 的写法——整个插件其实是在前端开源环境下,结合自身的需求而来的产物。

介绍

可能有读者看到这里还不是很清楚postcss-sprite 的运作方式。这里以Gulp 构建流为例,讲述下其运作方式。

假设你的项目目录如下:

.
├── gulpfile.js
├── dist
└── src
    ├── css
    │   └── index.css
    ├── html
    │   └── index.html
    └── slice
        └── filetype
            ├── doc.png
            ├── doc@2x.png
            ├── pdf.png
            └── pdf@2x.png

src 是放编译前的CSS(现在一般是Sass 或Less 的源文件)以及雪碧图源图(即单个小图);dist则是编译后 CSS 及产生的雪碧图图片及其CSS。

然后在gulpfile.js 配置如下:

var gulp = require('gulp');
var postcss = require('gulp-postcss');
var lazysprite = require('postcss-lazysprite');

gulp.task('css', function () {
	return gulp.src('./src/css/**/*.css')
		.pipe(postcss([lazysprite({
			imagePath:'./src/slice',
			stylesheetInput: './src/css',
			stylesheetRelative: './dist/css',
			spritePath: './dist/slice',
			smartUpdate: true,
			nameSpace: 'icon-'
		})]))
		.pipe(gulp.dest('./test/dist/css'));
});

上面的每个option 解释下:

imagePath:雪碧图小图所在目录;
stylesheetInput:CSS 文件所在的目录,一般与gulp.src的路径相关;
stylesheetRelative:为了在生成的CSS 中构造相对路径而引入,一般与gulp.dest的路径相关;
spritePath:生成的雪碧图放置的目录;
smartUpdate: 是否启用智能更新机制,关于smartUpdate,请见下一章节的介绍。
nameSpace:CSS 的命名空间。

注意下你的gulp css任务一般是gulp.watch以及默认任务的一部分。

然后你在src/css/index.css里面写下这段话:

@lazysprite "filetype";

输出内容见上一章节相同部分,就不重复了。

filetype即是在spritePath: './dist/slice'定义的目录下的子目录,这个目录下的所有雪碧图小图会合成为一张雪碧图,图片名称默认是以filetype.png命名。

同时filetype也会作为生成的小图对应CSS class 的一部分。CSS class 的构成即是“命名空间+目录名+小图片名”。如doc.png生成的对应类名为.icon-filetype-doc——然后你在HTML 中引入CSS 文件,通过<i class="icon-filetype-doc"></i>用即可。

postcss-lazysprite 虽然是站在巨人的肩膀上的产物,但其还是有不少亮点值得一说。

亮点

更多

npm 安装:

npm i postcss-lazysprite -S

插件本身拥有近十个 opiton 方便用户根据实际需求自定义相关细节,请参考 README

postcss-lazysprite 托管到 Github 上:https://github.com/Jeff2Ma/postcss-lazysprite,欢迎前往提 issues 或参与开发。当然,欢迎先送个star ~

相关文章:

从0到1:PostCSS 插件开发最佳实践

PostCSS 插件postcss-lazyimagecss:自动填写width / height 属性