首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >postcss-lazysprite: 一种生成CSS 雪碧图的懒惰姿势

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

作者头像
Jeff
发布2018-01-22 11:07:45
1.6K0
发布2018-01-22 11:07:45
举报
文章被收录于专栏:DeveWorkDeveWork

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 虽然是站在巨人的肩膀上的产物,但其还是有不少亮点值得一说。

亮点

  • 支持 Retina 不是什么新鲜事,但postcss-lazysprite 支持@2x, @3x, _2x, _3x这四种后缀的 Retina 图片,而且'@'与'_'的命名完全可以混用。
  • 检测到非标准 Retina 图片会予以提示,如@2x 图片非偶数尺寸的时候。
  • 支持Source Map,这个不多说,之所以是基于 Postcss 开发,就是为了能支持Source Map。
  • 支持:hover、:active这类场景,即一些如鼠标 hover 上去需要变logo 的场景。
  • 采用缓存方式以及SmartUpdate 以提升运行时候的性能。如本文开头所言,postcss-lazysprite 目标是开发阶段就能用上雪碧图,所以缓存机制很重要,总不能在开发阶段每保存一次 CSS 就重新走一遍“遍历所有图片并生成雪碧图”的流程。所以只要在开发阶段没有动过图片或修改@lazysprite 的代码,除开发阶段第一次启动 Gulp 任务的时候,其它时间均不会重复运行相关流程。另外在配置了SmartUpdate后,会将生成的图片文件名加入 hash,这样下一次启动 Gulp 任务的时候,只要源图片没有变化,也不会重复雪碧图流程。

更多

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 属性

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2017/06/05,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 对比与不同
  • 介绍
  • 亮点
  • 更多
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档