cropperjs图片裁剪及数据提交文件流互相转换详解

cropperjs的主要功能是图片裁剪,是一款前端常用的的图片裁剪工具,可根据相关api配置裁剪出符合自己业务需要的图片,具体使用如下:

  1. npm 引用
npm i cropperjs
  • 1
  1. 业务中引入
import Cropper from 'cropperjs';
  • 1
  1. 文件中单独引入方式
<link  href="/path/to/cropper.css" rel="stylesheet">
<script src="/path/to/cropper.js"></script>
  • 1
  • 2
  1. 初始化图片裁剪
new Cropper(element, options)
  • 1

参数:

element:  需要裁剪的图片元素,一般指本地获取到的img展示标签
options: {
	aspectRatio: 1 / 1, // 裁剪框纵横尺寸比例
	autoCropArea: 1,  // 它应该是一个介于 0 和 1 之间的数字。定义自动裁剪区域大小(百分比), 默认80%
	viewMode: 1,  // 视图模式
	dragMode: "move", // 图片可移动 拖拽模式
	cropBoxMovable:false, //是否可以拖拽裁剪框
	preview:ele,// Dom元素,该元素的预览尺寸样式尽量和aspectRatio尺寸比例保持一致
	responsive: true, // 调整窗口大小时重新渲染裁剪器
	modal:  true,// 在图像上方和裁剪框下方显示黑色模态
	rotatable:  true,// 启用以旋转图像
	scalable: true, // 启用以缩放图像
	zoomable:  true,// 启用以缩放图像
	zoomOnTouch: true,  // 启用通过拖动触摸来缩放图像
	zoomOnWheel: true, //鼠标滚轮缩放
	cropBoxMovable: false, // 裁剪框可移动
	cropBoxResizable: false, // 裁剪框大小可调整
	resizable: false, // 是否允许改变裁剪框大小
	ready: Function,  // 裁剪实例准备完成回调,由于加载图片时有一个异步过程,所以大部分方法都应该在 ready 之后调用
	reset: Function,  // reset() 重置
	clear: Function,  // clear() 清除
	replace(url, hasSameSize): Function,  // url 图片地址, hasSameSize:Boolean,如果新图像与旧图像大小相同,则不会重建裁剪器,只会更新所有相关图像的 URL。这可用于应用过滤器
	...
}

配置项:

viewMode
type: Number
default: 0
option: 0:无限制
1: 限制裁剪框不超过画布的大小。
2: 限制最小画布大小以适合容器。如果画布和容器的比例不同,最小画布将被其中一个维度中的额外空间包围。
3: 限制最小画布大小以填充容器。如果画布和容器的比例不同,容器将无法在其中一个维度中容纳整个画布。定义裁剪器的视图模式。

如果将viewMode设置为0,裁剪框可以延伸到画布之外,而值为1、2或3将裁剪框限制为画布的大小。viewMode为2或3将额外将画布限制为容器。当画布和容器的比例相同时,2和3之间没有差异。

一. 首先通过input file拿到的本地展示路径有两种:

1.base64格式
2.url格式

base64获取方式: 通过FileReader实例完成后的onload事件获取
url方式:URL.createObjectURL(img) -浏览器可识别的URL图片路径

		uploadAwatar (value){ 
          // 图片上传成功后创建 URL
           const fileList = value.target.files; // input file文件
           let img = ele;  // 展示的裁剪图
           if (fileList.length) {
               // url 格式获取可识别的图片路径
               let imgUrl = URL.createObjectURL(fileList[0]);
               img.src = imgUrl;
               img.onload = function(){
                   setCutImg (fileList[0].type); // 裁剪函数
               }
               // 转base64
               / **
                if (typeof FileReader === 'function') { 
	                const reader = new FileReader();
	                reader.readAsDataURL(fileList[0]);
	                reader.onload = (event) => {
	                    var Base64Val = event.target.result;
	                     img.src = Base64Val;
	                    console.log( Base64Val)
	                }
	          } **/
           }
       }	

二. 通过上面有了本地图片展示就满足了图片裁剪的条件,传入dom, 初始化图片裁剪

       /**
       *  @param setCutImg 初始化裁剪函数
       *  @param imgEle 本地获取到的图片展示元素
       */
        setCutImg (type){
            let objOpt = {};
            let winW = cropperPhoto.data.winW - 20;  // 手机端两侧10px间距
            // 正方形头像裁剪,图片竖图,窄图始终以最小的边居中填充裁剪框
            if (imgEle.naturalWidth > imgEle.naturalHeight) {  // 横图
                objOpt = {
                    minCropBoxHeight: winW,
                    minCanvasHeight: winW,
                    minContainerHeight: winW,
                }
            } else { // 竖图
                objOpt = {
                    minCropBoxWidth: winW,
                    minCanvasWidth: winW,
                    minContainerWidth: winW,
                }
            }
            
            cropper = new Cropper(imgEle, {
                ...objOpt,
                aspectRatio: 1 / 1,
                autoCropArea: 1,
                viewMode: 1,
                dragMode: "move", //图片可移动
                cropBoxMovable:false, //是否可以拖拽裁剪框
                zoomOnTouch: true,  
                scalable: true,
                zoomable: true,
                cropBoxMovable: false, // 裁剪框可移动
                cropBoxResizable: false, // 裁剪框大小可调整
                resizable: false, // 是否允许改变裁剪框大小
                ready(){
                    let _this = this;
                        $('.upload-cut').off().on('click', '.cancel', ()=> { // 关闭时处理的逻辑...
                            _this.cropper && _this.cropper.destroy();  // 销毁实例
                        }).on('click', '.sure', async ()=> {  // 确认裁剪的逻辑
                            let cas = _this.cropper.getCroppedCanvas({
                                width: winW,  // 根据需求配置最终裁完的图片宽
                                height: winW,  // 根据需求配置最终裁完的图片高
                                maxWidth: 500,   // 头像所以我这给的最大是500
                                maxHeight: 500, 
                                fillColor: '#fff', // 如果有空白背景色填充
                                imageSmoothingEnabled: false,                            
                            }).toBlob(async(blob) => {
                            	// blob 流提交
                                var formData = new FormData();
                                /* *  
                                // 方法一
                                let arr = new Array(blob);
                                console.log(arr, 'blob');
                                let file = new File(arr, 'file', { type: blob.type,});
                                console.log(file, 'file');
                                formData.append('avatarFile', file); */
                                blob.lastModifiedDate = new Date();
                                blob.name = 'file';
                                blob.filename = 'file';
                                formData.append('avatarFile', blob); // 后端以avatarFile取到blob数据流
                                console.log(formData, 'formData');  // formdata类型数据提交
                                commitData.call(this, formData)   // 数据提交
                            })
                            /**
                            // 方法二
                            // 拿到base64 转成 file流提交
                           	 let base64url = cas.toDataURL(type);
                             let fileData = dataURLtoFile(base64url);
                            console.log(fileData, 'fileData');
                            var formData = new FormData(); // formdata类型数据提交
                            formData.append('avatarFile', fileData);
                           commitData.call(this, formData)  // 数据提交
                           **/

                            /**
                            // 方法三
                            // base64 转blob流转file流提交
                            let base64url = cas.toDataURL(type);
                            // 调用如下
                            let blob = dataURLtoBlob(base64url);
                            let fileData = blobToFile(blob, "fileName");
                            // 上传file就可以了
                            console.log(fileData, 'fileData');
                            var formData = new FormData();  // formdata类型数据提交
                            formData.append('avatarFile', fileData);
                            commitData.call(this, formData) // 数据提交
                            **/
                        })
                }
            });
        }
        function commitData(formData){
        	let _this = this;
			 $.ajax({
                   url: path,
                   	method: "POST",
                   	data: formData,
                   	success: function(res){
                   		....
                   		 _this.cropper && _this.cropper.destroy(); // 裁剪完成释放空间销毁实例
                   	},
                   	error: function(err){
                   		....
                   		 _this.cropper && _this.cropper.destroy(); // 裁剪完成释放空间销毁实例
                   	}
			})
 		}
		
		function dataURLtoFile (dataurl, filename = 'file') {  // base64转file流
            let arr = dataurl.split(',')
            let mime = arr[0].match(/:(.*?);/)[1] // 正则匹配文件类型
            let suffix = mime.split('/')[1]
            let bstr = atob(arr[1])
            let n = bstr.length
            let u8arr = new Uint8Array(n)
            while (n--) {
                u8arr[n] = bstr.charCodeAt(n)
            }
            return new File([u8arr], `${filename}.${suffix}`, {type: mime})
        },
        function dataURLtoBlob(toDataURL) { // base64转blob
            var arr = toDataURL.split(","),
              mime = arr[0].match(/:(.*?);/)[1],
              bstr = atob(arr[1]),
              n = bstr.length,
            u8arr = new Uint8Array(n);
            while (n--) {
                u8arr[n] = bstr.charCodeAt(n);
            }
            return new Blob([u8arr], { type: mime });
        },
        function blobToFile(Blob, fileName) { // blob 模拟file流
            Blob.lastModifiedDate = new Date(); // 或者Date.now(), 文件最近一次的修改时间
            Blob.name = fileName; // 文件名
            return Blob;
        }
 		

new File([data], fileName, options);

第一个参数是个数组,数组项可以是 ArrayBuffer, String 等等,第二个参数fileName指文件名称,第三个options是配置项,支持 type 和 lastModified 属性,type 可以传入 text/plain, text/html 等,lastModified 默认为 Date.now()

实例上的属性 说明
lastModified 返回文件最后的修改时间 ,是个时间戳
lastModifiedDate 返回文件最后的修改时间,一个 Date 对象name文件名称
size 文件大小
webkitRelativePath 文件的本地路径或者
type 文件的MIME 类型
const file = new File(["foo"], "foo.txt", {
  type: "text/plain",
  lastModified: Date.now()
})
file.name // foo.txt

FileList

FileList 一个 File 的数组,它只有一个方法:

files.item(i) //  == files[i]
  • 1

new Blob([data], options);

与File构造函数类似,第一个参数是个数组,数组项可以是 ArrayBuffer, String 等等,第二个是配置项,最常用的就是 type 属性,可以传入 text/plain, text/html 等

属性和方法 说明
sizeBlob 对象中所包含数据的大小(字节)
type 一个字符串,表明该 Blob 对象所包含数据的 MIME 类型
slice(start, end) 返回一个新的 Blob对象,包含了源 Blob 对象中指定范围内的数据。和字符串的 slice 方法类似
stream() 返回一个能读取 blob 内容的 ReadableStream
text() 返回一个 promise 且包含 blob 所有内容的UTF-8格式的字符串
arrayBuffer() 返回一个promise且包含blob所有内容的二进制格式的 ArrayBuffer
const blob = new Blob(['hello world'], { type: 'text/plain' })
blob.text().then(console.log) // 'hello world'
  • 1
  • 2

FileReader

FileReader 对象允许 Web 应用程序异步读取存储在用户计算机上的文件(或原始数据缓冲区)的内容,可以读取 Blob 和 File 的数据。

一个简单的使用例子,初始化后,监听 load 事件,然后调用读取方法。

const reader = new FileReader();
reader.onload = function(evt) {
  console.log(evt.target.result);
};
reader.readAsText(file)
事件 说明
onabort 读取操作被中断事件
onerror 读取操作发生错误的事件
onload 读取操作完成的事件
onloadstart 该事件在读取操作开始时触发
onloadend 该事件在读取操作结束时(要么成功,要么失败)触发
onprogress 取 Blob 时触发
方法 说明
abort 中止读取readAsArrayBuffer开始读取数据,读取完后 result 是 ArrayBuffer 对象
readAsBinaryString 开始读取数据,读取完后 result 是二进制数据
readAsData URL开始读取数据,读取完后 result 是 Base64 字符串
readAsText 开始读取数据,读取完后 result 是字符串
备注:还未亲自测试,但应该可以,值得参考
THE END