参数
lrz(file, [options]);
1、file 通过 input:file 得到的文件,或者直接传入图片路径
2、[options] 这个参数允许忽略
3、width {Number} 图片最大不超过的宽度,默认为原图宽度,高度不设时会适应宽度。
4、height {Number} 同上
5、quality {Number} 图片压缩质量,取值 0 - 1,默认为0.7
6、fieldName {String} 后端接收的字段名,默认:file
返回结果
返回值是一个promise对象
then(rst)
rst.formData 后端可处理的数据
rst.file 压缩后的file对象(默认已经丢在rst.formData有一份了),需要注意的是如果压缩率太低的话,这个会是原始的file对象
rst.fileLen 生成后的图片的大小,后端可以通过此值来校验是否传输完整
rst.base64 生成后的图片base64,后端可以处理此字符串为图片,也直接用于img.src = base64
rst.base64Len 生成后的base64的大小,后端可以通过此值来校验是否传输完整 (如果采用base64上传方式)
rst.origin 也就是原始的file对象,里面存了一些原始文件的信息,例如大小,日期等。
catch(err)
always()
小例子:
// this.files[0] 是用户选择的文件
lrz(this.files[0], {width: 1024})
.then(function (rst) {
// 展示处理好的图片
var img = new Image();
img.src = rst.base64;
img.onload = function () {
document.body.appendChild(img);
};
return rst;
}).then(function (rst) {
// 跟后台进行ajax数据交互,把数据传给后端
/* ==================================================== */
$.ajax({
url: 'http://koa-upload.coding.io', // 这个地址做了跨域处理,可以用于实际调试
data: rst.formData,
processData: false,
contentType: false,
type: 'POST',
success: function (data) {
alert(JSON.stringify(data));
}
});
/* ==================================================== */
return rst;
}).catch(function (err) {
// 如果出错了,这里可以捕捉到错误信息
// 而且以上的then都不会执行
alert(err);
}).always(function () {
// 不管是成功失败,这里都会执行
});