需求说明
简单来说就是要实现用户上传头像,并且要保存用户裁切后的部分作为用户头像。
第一步,选择图片:
第二步,在弹窗页面中展现并进行裁切:
第三步,点击“保存”,上传服务器。
实现过程
说来有点坎坷,相当于做了2遍,走了弯路。
第1遍是用户一选择图片,就进行了上传,然后返回一个地址,所以在弹层上展现的图片已经是服务器上的图片了,然后进行裁切,再保存。
第2遍找到的一个方法,是在第1遍做到裁切处理时候想到的,即弹层展现的是用户机器上选择的图片,不用先上传,但是用image/base64来展现的。这样就与服务器少了一次交互啊,并且服务器不用存储2遍图片,还提高了弹层展现速度,体验更好,所以是极好的。
说下碰到的主要技术点:
- express框架不用多说,就是保存的时候post一下裁切后的base64数据,后台写个对应路由就好。
- Jquery也不用多说,页面展现控制与ajax提交。
- HTML5/FileReader/canvas,FileReader用于将文件读取为数据,我们使用它的
onLoad
事件;canvas这个用作裁切移动时,实时重绘裁切后的图片(相当于实时预览,当然我是隐藏了,调试的时候可以让他display),可以隐藏,最后上传的其实就是这个canvas的base64数据。 - Jcrop plugin。这个是裁切插件,必须的了。下载与说明在这里。
- 其他就是base64字符串保存成图片了,这在服务端比较简单,直接用
fs.writeFile(fileName,dataBuffer,function(err){});
就好了。
具体代码
view页面,主要需要有一个上传控件,还有定义弹窗div以及用于重绘裁切范围图片的canvas,当然页面要引用相应的js插件和css等,主要:
<link rel="stylesheet" href="/css/jquery.Jcrop.css">
<script src="/js/jquery.js"></script>
<script src="/js/jquery.Jcrop.js"></script>
<!--上传控件-->
<input type="file" name="upLoadImg1" id="upLoadImg1">
<!--弹窗与裁切图-->
<div class="cover">
<img id="Img1" alt="">
<button id="btnSave">保存</button>
</div>
<!--裁切范围重绘canvas-->
<canvas id="myCanva" width="200" height="200">
js/jquery,处理图片加载与裁切上传。
首先要监控上传控件的变化,因为我们这里没有按钮来触发,所以直接监控upLoadImg1
的change
来触发。
$(‘#upLoadImg1‘).on(‘change‘, function() {
if (document.getElementById("upLoadImg1").files.length === 0) {
return;
}
var oFile = document.getElementById("upLoadImg1").files[0];
if (!oFile) {
return;
}
var fileName = oFile.name;
var fileSize = oFile.size;
var fileType = fileName.substring(fileName.lastIndexOf(‘.‘), fileName.length).toLowerCase();
if (fileType != ‘.jpg‘ && fileType != ‘.jpeg‘ && fileType != ‘.gif‘ && fileType != ‘.png‘ && fileType != ‘.bmp‘) {
alert("请选择jpg,png,gif,bmp格式的图片");
return;
}
if (fileSize > 2 * 1024 * 1024) {
alert(‘最大支持2MB的图片‘);
return;
}
var fileReader = new FileReader();
fileReader.readAsDataURL(oFile);
// 成功读取
fileReader.onload = function(e) {
// 显示弹窗
$(‘.cover‘).show();
// 将弹窗中的图片路径设置为选择的图片的base64
$(‘#Img1‘).attr(‘src‘, e.target.result);
// 裁切组件初始化
initJcrop();
};
});
裁切在弹窗一显示的时候就应该初始化:
function initJcrop() {
$(‘#Img1‘).Jcrop({
onChange: updateCoords,
onSelect: updateCoords,
aspectRatio: 1,
boxWidth: 300,
boxHeight: 300
}, function() {
//弹窗中显示的图片尺寸
var bb = this.getBounds();
var bWidth = Number(bb[0]) / 2;
var bHeight = Number(bb[1]) / 2;
//设置初始选中裁切范围
this.setSelect([0, 0, bWidth, bHeight]);
//原始图片缩小比例
try {
wdthScale = $(‘#Img1‘)["0"].width / 222;
heightScale = $(‘#Img1‘)["0"].height / 238;
} catch (e) {}
jcrop_api = this;
});
}
非常重要的一个坑是,在此之前要定义全局变量jcrop_api
,widthScale
和heightScale
,2个scale变量用于记录选择的原始图片尺寸与在弹窗上展现尺寸的缩小/放大比例的,比如选择的是1024x768的图片,但是弹窗上展现的范围是222x238,这就需要将缩小的倍数记录下来,在裁切的重绘canvas的时候要乘以这个倍数,否则裁切的范围就是在这个222x236尺寸上裁切的,而不是原始图片的尺寸上裁切的。而前面的jcrop_api
变量用于重新选择图片时要将上一次的裁切初始化组件destroy
掉。
Jcrop
组件中重要的事件:onChange和onSelect,用于确定裁切范围的坐标(尺寸),因此也非常重要,其实重绘canvas就是在这里面完成的。
function updateCoords(c) {
var img = document.getElementById(‘Img1‘);
var ctx = document.getElementById(‘myCanva‘).getContext(‘2d‘);
try {
wdthScale = wdthScale === 1 ? $(‘#Img1‘)["0"].width / 222 : wdthScale;
heightScale = heightScale === 1 ? $(‘#Img1‘)["0"].height / 238 : heightScale;
} catch (e) { }
//绘制canvas画布
ctx.drawImage(img, c.x, c.y, c.w * wdthScale, c.h * heightScale, 0, 0, 200, 200);
}
另外就是处理保存按钮来,一个ajax来提交canvas形成的图片的base64字符串,后台接受保存就可以了。
var data = document.getElementById(‘myCanva‘).toDataURL();
$.ajax({
url: ‘/xxxx‘,
type: ‘POST‘,
dataType: ‘JSON‘,
cache: false,
data: {
‘imgData‘: data
},
success: function(res) {},
error: function(err) {}
});
这就是上传裁切(实时预览)的全部过程了。