手把手教你如何编写一个前端图片压缩、方向纠正、预览、上传插件

前言

今天我们要讲解下如何编写一个图片压缩、方向纠正插件,附带着会讲解下如何上传和预览。

为什么重点放在图片压缩和方向纠正?

相信大家在做项目过程中,经常会遇到上传图片到后端,但是由于图片过大,需要对图片压缩处理。特别在移动端,手机拍的照片普遍过于大了,我们有时候只是需要上传一张头像,很小就够用了。还有在部分手机上(已知苹果手机)拍的照片存在方向角度问题,这时就需要我们来纠正图片角度了。

很多同学多数时候是在用别人写好的图片压缩上传插件。针对我们的需求,这些插件有时候不能达到我们最理想的效果,自己写呢,又不会写,很是头疼。今天就深入剖析讲解下,教会大家编写自己的图片压缩、方向纠正插件,以及预览和上传压缩后图片数据。

文中用到的一些H5的api和EXIF.js等知识点如果不懂的话,请先阅读文末尾的结语中的知识点资料。


实现原理

压缩图片并且上传主要用到filereader、canvas 以及 formdata 这三个h5的api和插件EXIF.js。逻辑并不难。整个过程就是:

  (1)用户使用input file上传图片的时候,用filereader读取用户上传的图片数据(base64格式)

  (2)把图片数据传入img对象,然后将img绘制到canvas上,用EXIF.js对图片方向进行纠正,再调用canvas.toDataURL对图片进行压缩,获取到压缩后的base64格式图片数据,转成二进制

  (3)获取到压缩后的图片二进制数据,预览。

  (4)将压缩后的图片二进制数据塞入formdata,再通过XmlHttpRequest提交formdata

  如此四步,就完成了图片的压缩、方向纠正、预览和上传。


插件设计思考

考虑到在实际项目中,可能用不同的开发框架(vue.js/JQ/react.js/angular.js/anu.js等),图片预览的UI样式也可能不同,图片数据上传方法可能不同。因为图片压缩和方向纠正这两块的逻辑多变性比较低,我们这里把图片压缩和方向纠正抽离出来,封装为一个插件库。


【一】获取图片数据

先是获取图片数据,也就是监听input file的change事件,然后获取到用来压缩上传的文件对象files,将files传到【图片压缩、方向纠正插件】中进行处理。

这时候根据每个人的需求,也可以预览未压缩的图片。

//监听上传组件input的onchange事件,压缩图片,纠正图片方向,同时获取压缩后的图片
filechooser.onchange = function () {
    var fileList = this.files;
    
    //预览压缩前的图片
    var files = Array.prototype.slice.call(fileList);
    files.forEach(function (file, i) {
        var reader = new FileReader();
        reader.onload = function () {
            var li = document.createElement("li")
            li.style.backgroundImage = 'url('+this.result+')';
            document.querySelector('.img_list').appendChild(li)
        }
        reader.readAsDataURL(file);
    });

    //处理图片列表,getCompressiveFileList接受处理后的图片数据列表
    //下面两行代码为图片压缩、方向纠正插件的用法,具体实现细节请继续往下阅读 ~_~ ↓↓↓
    var process = window.lzImgProcess();
    process(fileList, getCompressiveFileList);
}
复制代码

【二】图片压缩、方向纠正插件实现

上面做完图片数据的获取后,就可以做process压缩图片的方法了。而压缩图片也并不是直接把图片绘制到canvas再调用一下toDataURL就行的。

  在IOS中,canvas绘制图片是有两个限制的:

  首先是图片的大小,如果图片的大小超过两百万像素,图片也是无法绘制到canvas上的,调用drawImage的时候不会报错,但是你用toDataURL获取图片数据的时候获取到的是空的图片数据。

  再者就是canvas的大小有限制,如果canvas的大小大于大概五百万像素(即宽高乘积)的时候,不仅图片画不出来,其他什么东西也都是画不出来的。

  应对上面两种限制,我把图片宽度、高度压缩控制在1000px以内,这样图片最大就不超过两百万像素了。在前端开发中,1000px*1000px基本可以满足绝大部分的需求了。当然了还有更完美的瓦片式绘制的方法,我们这里就说瓦片式绘制方法了。

  如此一来就解决了IOS上的两种限制了。

  除了上面所述的限制,还有两个坑,一个就是canvas的toDataURL是只能压缩jpg的(这句话的详细解释可以看下面的Tip讲解),当用户上传的图片是png的话,就需要转成jpg,也就是统一用canvas.toDataURL('image/jpeg', 0.5) , 类型统一设成jpeg,而压缩比就自己控制了。

  另一个就是如果是png转jpg,绘制到canvas上的时候,canvas存在透明区域的话,当转成jpg的时候透明区域会变成黑色,因为canvas的透明像素默认为rgba(0,0,0,0),所以转成jpg就变成rgba(0,0,0,1)了,也就是透明背景会变成了黑色。解决办法就是绘制之前在canvas上铺一层白色的底色。

  在压缩图片之前,我们判断图片角度,如果图片角度不正确,还需要用EXIF.js把图片角度纠正过来。

  压缩完图片,把base64的图片数据转成二进制数据存储到暂存区中,等待被getBlobList获取使用。

Tip: canvas的toDataURL是只能压缩jpg这句话我可能说的不清楚,我想表达的意思是这个api无论是jpeg还是png,最后导出的时候,都跟jpeg没啥差别了。因为png图片的透明性质在canvas中是无效的,会被canvas添加默认的黑色背景,我在文中讲解的时候,用白色背景处理了,所以最后导出的图片,无论你设置的是png还是jpeg都跟jpeg没啥区别了,因为无法保持png的透明度性质了

(function(window) {

    /**
     * 
     * 作者:混沌传奇
     * 
     * 邮箱地址:[email protected]
     * 
     * 日期:2017-10-26
     * 
     * 插件功能:压缩图片&&纠正图片方向&&返回二进制(Blob)图片元数据组成的列表
     * 
     */

    window.lzImgProcess = function () {


        var Orientation = '', //图片方向角
            blobList = [], //压缩后的二进制图片数据列表

            canvas = document.createElement("canvas"), //用于压缩图片(纠正图片方向)的canvas
            ctx = canvas.getContext('2d'),

            file_type = 'image/jpeg', //图片类型
            qlty = 0.5, //图片压缩品质,默认是0.5,可选范围是0-1的数字类型的值,可配置
            imgWH = 1000; //压缩后的图片的最大宽度和高度,默认是1000px,可配置


        /**
         * @actionName process, 
         *        方法功能:压缩图片&&纠正图片方向&&返回二进制(Blob)图片元数据
         * 
         * @param fileList,传入函数的文件列表对象,fileList对象是来自用户在一个元素上选择文件后返回的FileList对象
         *        注意:图片类型必须是jpeg||png
         *        比如: 
         *              function loadImageFile() {
         *                //获取返回的fileList对象
         *                var fileList = document.getElementById("uploadImage").files;
         *              }
         * @param getBlobList [Blob],获取压缩结果的钩子函数,接受一个参数。
         *        功能:在图片压缩完毕后,获取压缩后的二进制图片数据对象组成的数组,参数即:压缩后的二进制图片数据(blob)组成的list
         *        
         * @param quality,传入函数的图片压缩比率(品质),可选范围0-1的数字类型的值,默认是0.5
         *
         * @param WH,传入函数的图片压缩后的最大图片宽度和高度,默认是1000,单位是px,可自由配置。
         *        注意:最好不要超过1000,数字过大,容易导致canvas压缩失败。由于没做瓦片处理,所以有这个限制。1000*1000的图片在前端中,基本也够用了。
         *        
         */
        function process (fileList, getBlobList, quality, WH) {
            blobList = []; //初始化blobList
            // 判断参数fileList的长度是否大于0
            if (!fileList.length){
                console.log('警告:传进方法process的参数fileList长度必须大于零!!!')
                return;
            }

            //如果quality参数有值,则把quality赋值给qlty(图片压缩的品质)
            if(quality)
                qlty = quality;

            //如果WH参数有值,则把WH赋值给imgWH(压缩后的图片的最大宽度和高度)
            if(WH&&WH<1000&&WH>0){
                imgWH = WH;
            }

            // 把传进来的fileList转为数组类型
            var files = Array.prototype.slice.call(fileList);
            
            files.forEach(function (file, i) {
                if (!/\/(?:jpeg|png)/i.test(file.type)){
                    console.log('警告:图片必须是jpeg||png类型!!!');
                    return;
                }
                // file_type = file.type;
                
                var reader = new FileReader();

                // 获取图片压缩前大小,打印图片压缩前大小
                var size = file.size/1024 > 1024 ? (~~(10*file.size/1024/1024))/10 + "MB" :  ~~(file.size/1024) + "KB";
                // console.log('size:', size)

                reader.onload = function () {
                    var img = new Image();
                    img.src = this.result;

                    // 图片加载完毕之后进行压缩
                    if (img.complete) {
                        callback();
                    } else {
                        img.onload = callback;
                    }

                    function callback() {
                        //获取照片方向角属性,用户旋转控制  
                        EXIF.getData(img, function() {
                            // alert(EXIF.pretty(this));
                            EXIF.getAllTags(this);   
                            // alert(EXIF.getTag(this, 'Orientation'));
                            Orientation = EXIF.getTag(this, 'Orientation'); 
							console.log('Orientation:', Orientation)
                            if(Orientation == ""||Orientation == undefined||Orientation == null){
                                Orientation = 1;
                            }
                        });

                        //获取压缩后的图片二进制数据
                        var data = GetImgCompress(img);

                        //将二进制数据塞入到二进制数据列表中
                        blobList.push(data);

                        //将压缩后的二进制图片数据对象(blob)组成的list通过钩子函数返回出去
                        if(blobList.length===files.length){
                            if(getBlobList)
                                getBlobList(blobList);
                        }
                        
                        img = null;
                    }

                };

                reader.readAsDataURL(file);
            })
        }


        /**
         * @actionName GetImgCompress,
         *     功能:判断上传图片的方向,如果不是正确的,进行修正,并对图片进行压缩,压缩完后,返回压缩后的二进制图片数据
         *     
         * @param img, 用来压缩的图片对象
         * 
         * @returns 返回的压缩后的二进制图片数据
         */
        function GetImgCompress(img){
            //如果方向角不为1,都需要进行旋转
            if(Orientation != 1){
                switch(Orientation){
                    case 6://需要顺时针90度旋转
                        rotateImg(img,'right',canvas);
                        break;
                    case 8://需要逆时针90度旋转
                        rotateImg(img,'left',canvas);
                        break;
                    case 3://需要180度旋转
                        rotateImg(img,'right2',canvas);//转两次
                        break;
                }
            }else{
                //不做旋转
                rotateImg(img,'no',canvas);
            }

            var ndata;
            
            ndata = canvas.toDataURL(file_type, qlty);
            
            //打印压缩前后的大小,以及压缩比率
            // var initSize = img.src.length;
            // console.log('压缩前:' + initSize);
            // console.log('压缩后:' + ndata.length, 'base64数据', ndata);
            // console.log('压缩率:' + ~~(100 * (initSize - ndata.length) / initSize) + "%");


            //将压缩后的base64数据转为二进制数据
            ndata = dataURItoBlob(ndata);

            //清除canvas画布的宽高
            canvas.width = canvas.height = 0;
            
            return ndata;
        }



        /**
         * @actionName rotateImg,
         *     功能:对图片旋转处理
         *     
         * @param img, 用来矫正方向的图片对象
         * 
         * @param direction, 旋转方向
         *
         * @param canvas, 用来绘制图片的cavas画布对象
         */
        function rotateImg(img, direction,canvas) {    
            
            //最小与最大旋转方向,图片旋转4次后回到原方向    
            var min_step = 0;
            var max_step = 3;
            if (img == null)return;    
            //img的高度和宽度不能在img元素隐藏后获取,否则会出错    
            var height = img.height;    
            var width = img.width;

            if(width>imgWH || height>imgWH){
                var ratio = ~~(height/width*10)/10;
                if(width>height){
                    width = imgWH;
                    height = imgWH*ratio;
                }else{
                    height = imgWH;
                    width = height/ratio;
                }
                img.width = width;
                img.height = height;
            }

            var step = 2;    
            if (step == null) {    
                step = min_step;    
            }
            if (direction == 'no'){
                step = 0;    
            } else if (direction == 'left') {    
                step++;    
                //旋转到原位置,即超过最大值    
                step > max_step && (step = min_step);    
            } else if (direction == 'right') {			
				step--;    
                step < min_step && (step = max_step);    
			} else {    
                //旋转180度
            }

            //旋转角度以弧度值为参数    
            var degree = step * 90 * Math.PI / 180; 

            switch (step) {
                case 0:
                    canvas.width = width;    
                    canvas.height = height;   

                    // 铺底色
                    ctx.fillStyle = "#fff";
                    ctx.fillRect(0, 0, width, height);
                    ctx.drawImage(img, 0, 0, width, height);   
                    break;    
                case 1:
                    canvas.width = height;    
                    canvas.height = width;   

                    // 铺底色
                    ctx.fillStyle = "#fff";
                    ctx.fillRect(0, 0, height, width);
                    ctx.rotate(degree);    
                    ctx.drawImage(img, 0, -height, width, height);    
                    break;
                case 2:
                    canvas.width = width;    
                    canvas.height = height;   

                    // 铺底色
                    ctx.fillStyle = "#fff";
                    ctx.fillRect(0, 0, width, height);
                    ctx.rotate(degree);    
                    ctx.drawImage(img, -width, -height, width, height);    
                    break;    
                case 3:
                    canvas.width = height;    
                    canvas.height = width;   

                    // 铺底色
                    ctx.fillStyle = "#fff";
                    ctx.fillRect(0, 0, height, width);
                    ctx.rotate(degree);    
                    ctx.drawImage(img, -width, 0, width, height);    
                    break;
            }
        }




        /**
         * dataURL to blob, ref to https://gist.github.com/fupslot/5015897
         * @param dataURI,图片的base64格式数据
         * @returns {Blob}
         */
        function dataURItoBlob(dataURI) {
            var byteString = atob(dataURI.split(',')[1]);
            var mimeString = dataURI.split(',')[0].split(':')[1].split(';')[0];
            var ab = new ArrayBuffer(byteString.length);
            var ia = new Uint8Array(ab);
            for (var i = 0; i < byteString.length; i++) {
                ia[i] = byteString.charCodeAt(i);
            }
            return new Blob([ab], {type: mimeString});
        }




        /**
         * 返回一个process方法
         * 
         * process方法:用来压缩图片数据,在压缩图片的同时,默认会调用correctOrientation方法纠正图片方向。
         * 
         */
        return process;


    }
})(window)
复制代码

Exif.js 提供了 JavaScript 读取图像的原始数据的功能扩展,例如:拍照方向、相机设备型号、拍摄时间、ISO 感光度、GPS 地理位置等数据。
Exif.js官方github 仓库地址:github.com/exif-js/exi…


【三】获取压缩后的图片二进制数据,预览图片

完成图片压缩后,就可以获取压缩后的图片二进制数据了,把获取到的图片二进制数据存起来;获取到数据后,可以拿来预览。

由于实际项目中,每个项目的UI样式设计可能不一样,开发者可以根据自己的UI样式来预览图片。

//获取压缩后的图片
function getCompressiveFileList(fileList) {
    blobFileList = fileList;
    // console.log('fileBlobList:', fileList);
    fileList.forEach(function (blob) {
        var reader = new FileReader();
        reader.onload = function () {
            var li = document.createElement("LI")
            li.style.backgroundImage = 'url('+this.result+')';
            document.querySelector('.imgCompress_list').appendChild(li)
        }
        reader.readAsDataURL(blob);
    })
}
复制代码

【四】提交图片数据到后台

new一个formdata对象,将上一步获取到的 blobFileList 图片二进制数据 append 到 formdata中,用任意你喜欢的ajax库进行上传。当然也可以用原生ajax上传。

//将压缩后的二进制图片数据流append到formdata对象中上传到后台服务器
//注意:上传的是formdata对象,后台接口接收的时候,也要从formdata对象中读取二进制数据流
function formUpData(blobFiles){
    var formData = new FormData();

    formData.append("files", blobFiles);
    
    var xhr = new XMLHttpRequest();
    
    //链接你自己上传图片接口即可,这里的接口地址,是我写的示例,不可真实使用,讲解意义更大
    xhr.open('post', 'http://xxx/welcome/index/');

    xhr.onreadystatechange = function () {
        if (xhr.readyState == 4 && xhr.status == 200) {
                console.log('上传成功!');
        }
    };

    xhr.send(formData);
}
复制代码

结语

完整代码以及demo:git仓库地址

文中用到了一些H5的知识点,不懂的童鞋可以进入下面的知识点资料地址,详细阅读
HTMLCanvasElement.toDataURL()
CanvasRenderingContext2D.drawImage()
FileReader()
FormData
Blob()
EXIF.js中文博客文章

喜欢这篇文章的话,请关注我,我会持续更新技术文章到我的掘金主页。谢谢支持~
喜欢交流前端技术的朋友可以加我的QQ群:583575104 或 366420656

你可能感兴趣的:(前端,移动开发,ui)