小程序对上传的代码有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中。