如何在小程序中使用雪碧图

小程序对上传的代码有2M的大小限制，因此一般在小程序中使用icon的时候，要么是用icon-font，要么就是将icon图片上传到cdn再使用，而不会将图片放在本地。但是使用icon-font有一个问题，就是不能使用渐变色，因此，需要渐变色的icon都只能使用图片来完成。如果这样的icon少还可以手动一张张上传到cdn，但是多到10-20张，手动传就是一件耗时费力的事了。因此，我们需要把我们的icon整合起来，做成一张雪碧图，然后将其上传到cdn，最后将cdn的地址替换到css中。在小程序中我们借助gulp来将这一系列步骤自动化，下面谈谈具体的实施方案。

目录结构

为了使我们的源码能使用更多的现代特性，我们将目录分为了src和dist两大目录，src存放我们的源码，而dist则存放gulp处理过后给小程序执行的代码。如下所示：

• icons: 该目录存放所有的图片icons
• style: 该目录存放共用的css，我们生成的雪碧图css也存放于此
• gulpfile: gulp任务配置文件

gulp配置

先安装依赖包

 yarn add sprity sprity-sass gulp gulp-if gulp-sass gulp-rename gulp-replace -D

我们采用sprity这个库来处理雪碧图，而sprity-sass则是针对scss的一个处理器。gulp-sass则是将scss文件处理为css，gulp-rename将其命名为小程序特有的wxss文件。

首先打开gulpfile编写我们的雪碧图处理代码，如下：

const gulp = require('gulp');
const sass = require('gulp-sass');
const rename = require('gulp-rename');
const sprity = require('sprity');
const gulpif = require('gulp-if');

gulp.task('sprity', () => {
    return sprity.src({
        src: './src/icons/**/*.{png,jpg}', // icon存放目录
        style: '_icon.scss', // 生成的icon文件
        processor: 'sass', // 处理器
    })
    .pipe(
        gulpif('*.png', gulp.dest('./src/sprity/'),  // 生成的雪碧图存放路径
        gulp.dest('./src/sprity/')) // 生成的icon存放路径
    );
});

写完后，我们执行gulp sprity，可以发现我们sprity文件夹下生成了一张sprity.png和_icon.scss文件，其内容如下：

$buy-discount-card: -0px -0px 76px 76px;
$buy-product: -0px -76px 76px 76px;
$buy-service: -0px -152px 76px 76px;
$buy-times-card: -0px -228px 76px 76px;
$home: -0px -304px 76px 76px;
@mixin sprite-width($sprite) {
  width: nth($sprite, 3);
}
@mixin sprite-height($sprite) {
  height: nth($sprite, 4);
}
@function sprite-width($sprite) {
   @return nth($sprite, 3);
}
@function sprite-height($sprite) {
   @return 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, $display: block) {
   @include sprite-position($sprite);
  background-repeat: no-repeat;
  overflow: hidden;
  display: $display;
  @include sprite-width($sprite);
  @include sprite-height($sprite);
}

.icon {
  background-image: url('../sprity/sprite.png');
}

如果不用上传到cdn，那么我们就可以直接引用这个文件了，其用法如下：

@import '_icon.scss'; // 引入生成的雪碧图文件
 
.icon-discount-card { // 编写icon
  @include sprite($buy-discount-card); // 此处的变量为_icon.scss前面几行定义的变量，这些变量的名称都是根据icon文件名来生成
}

.icon-home {
  @include sprite($home);
}

如上代码所示，我们就写好了我们的icon文件，到时候直接使用 icon icon-home即可。你可能会觉得还要自己手写图标会很麻烦，sprity也支持直接生成图标，不过得自己手动去写对应的模板，有兴趣的可以网上找一下相关资料，此处不展开。

雪碧图文件已经生成了，我们下一步要做的就是将其上传到cdn，这里我们的做法是使用node自带的spawn来执行shell命令，而这个shell命令会把我们的雪碧图上传到cdn上。在有赞内部，我们使用superman这个工具，如果读者是上传到别的cdn服务器，应该也会有相应的命令上传配置，建议找一下cdn的文档。gulp上传雪碧图代码如下：

const replace = require('gulp-replace');
const { spawn } = require('child_process');

gulp.task('cdn', () => {
    const reg = /\/\/img\.yzcdn\.cn(.+)\.png/g; // 匹配上传的路径
    const sm = spawn('superman', ['cdn', './src/sprity/sprite.png']); // 执行上传命令
    sm.stdout.on('data', (data) => {
        const d =  reg.exec(data);
        if(d && d.length > 0) { // 根据返回值来匹配
            gulp.src(['./src/sprity/_icon.scss'])
                .pipe(replace(/\.\.\/sprity\/sprite\.png/g, d[0])) // 替换本地雪碧图
                .pipe(gulp.dest('./src/style/'));
        }
    });
});

以上步骤做完后，基本就大功告成了。如果更进一步，我们可以把生成的scss的px改为微信建议的rpx，代码如下：

if(d && d.length > 0) { // 根据返回值来匹配
    gulp.src(['./src/sprity/_icon.scss'])
        .pipe(replace(/\.\.\/sprity\/sprite\.png/g, d[0])) // 替换本地雪碧图
        .pipe(replace(/(-?)(\d+)px/g, ($1, $2, $3) => {
            return $2 + parseInt($3) * 2 + 'rpx';
        }))
        .pipe(gulp.dest('./src/style/'));
}

以上，我们就完成了在小程序中使用雪碧图，为了能让我们一边写代码，一边能看到相应的输出，我们可以通过gulp来watch我们的文件，当检测到变化时就重新生成一份代码到dist中。