用過新浪微博的人應該都對它的頭像編輯器有印象,只不過對方是用 Flash 做的。某個專案裡也需要同樣的功能,本想直接沿用,但發現它有一部分請求路徑寫死在 Flash 內部,無法替換,只好放棄。
後來找到 jQuery 的 Jcrop,基本滿足需求,但它本身只做裁剪,沒有縮圖預覽。既然很多人應該都會需要,就把它封裝成一個可直接呼叫的元件。
官方網站:
https://deepliquid.com/content/Jcrop.html
站上有大量 demo,有興趣可以逛逛。
jQuery.UtrialAvatarCutter = function (config) {
var h, w, x, y;
var os, oh, ow;
var api = null;
var sel = this;
var img_content_id = config.content;
var img_id = "img_" + (Math.random() + "").substr(3, 8);
var purviews = new Array();
var select_width = null;
var select_height = null;
if (config.purviews) {
for (i = 0, c = config.purviews.length; i < c; ++i) {
purviews[purviews.length] = config.purviews[i];
}
}
// 初始化各縮圖容器
check_thums_img = function () {
if (config.purviews) {
for (i = 0, c = config.purviews.length; i < c; ++i) {
if ($('#' + config.purviews[i].id + " img").length == 0) {
$('#' + config.purviews[i].id).html("<img src='" + os + "'/>");
} else {
$('#' + config.purviews[i].id + " img").attr("src", os);
}
}
}
};
// 重新載入圖片(例如非同步上傳完成後)
this.reload = function (img_url) {
if (img_url != null && img_url != "") {
os = img_url + "?" + Math.random(); // 加隨機參數避免快取
$("#" + img_content_id).html("<img id='" + img_id + "' src='" + os + "'/>");
$("#" + img_id).bind("load", function () {
check_thums_img();
sel.init();
});
}
};
$("#" + img_content_id + " img").attr("id", img_id);
// 裁剪區域變動時,同步更新所有縮圖
var preview = function (c) {
if (c.w == 0 || c.h == 0) {
api.setSelect([x, y, x + w, y + h]);
api.animateTo([x, y, x + w, y + h]);
return;
}
x = c.x; y = c.y; w = c.w; h = c.h;
for (i = 0, c = purviews.length; i < c; ++i) {
var purview = purviews[i];
var rx = purview.width / w;
var ry = purview.height / h;
$('#' + purview.id + " img").css({
width : Math.round(rx * ow) + 'px',
height : Math.round(ry * oh) + 'px',
marginLeft: '-' + Math.round(rx * x) + 'px',
marginTop : '-' + Math.round(ry * y) + 'px'
});
}
};
this.init = function () {
if (api != null) { api.destroy(); }
os = $("#" + img_content_id + " img").attr("src");
if (os == "") return;
check_thums_img();
// 縮圖容器設為相對定位 + 隱藏溢出,才能用負邊距裁切
for (i = 0, c = purviews.length; i < c; ++i) {
var purview = purviews[i];
$("#" + purview.id).css({
position: "relative", overflow: "hidden",
height: purview.height + "px",
width : purview.width + "px"
});
}
oh = $('#' + img_id).height();
ow = $('#' + img_id).width();
select_width = Math.min(ow, config.selector.width);
select_height = Math.min(oh, config.selector.height);
x = ((ow - select_width) / 2);
y = ((oh - select_height) / 2);
// 這裡是原 Jcrop 的設定,修改此段可調整 Jcrop 的各種功能
api = $.Jcrop('#' + img_id, {
aspectRatio: 1,
onChange : preview,
onSelect : preview
});
api.animateTo([x, y, x + select_width, y + select_height]); // 預設選取框置中
};
// 對外提供裁剪結果
this.submit = function () {
return { w: w, h: h, x: x, y: y, s: os };
};
};
1. 引入檔案
<LINK href="css/jquery.Jcrop.css" type="text/css" rel="Stylesheet" media="screen" />
<script type="text/javascript" src="js/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="js/jquery.Jcrop.min.js"></script>
<script type="text/javascript" src="js/jQuery.UtrialAvatarCutter.js"></script>
2. 定義原圖與縮圖容器
<!-- 原始圖 -->
<div id="picture_original">
<img src="https://static.youhuiduo.net/Attatchment/72383/600X600/634030306987187500.jpg" />
</div>
<!-- 縮圖 -->
<div id="picture_200"></div>
<div id="picture_50"></div>
<div id="picture_30"></div>
3. 設定
var cutter = new jQuery.UtrialAvatarCutter({
// 主圖片所在容器 ID
content: "picture_original",
// 縮圖設定:id 為容器 ID,width / height 為縮圖尺寸
purviews: [
{ id: "picture_200", width: 200, height: 200 },
{ id: "picture_50", width: 50, height: 50 },
{ id: "picture_30", width: 30, height: 30 }
],
// 選取框預設大小
selector: { width: 200, height: 200 }
});
4. 觸發初始化
$(window).load(function () {
cutter.init();
});
這裡刻意用 window.load 而不是 document.ready,因為 Jcrop 需要圖片的真實尺寸才能計算比例,而 ready 觸發時圖片可能還沒下載完。
5. 非同步上傳時更新圖片
若使用 Ajax 上傳,拿到新圖網址後呼叫 cutter.reload(imgs_url) 即可即時替換,不必重建整個元件。
最後,submit() 回傳的 { w, h, x, y, s } 就是後端裁圖所需的全部參數:寬、高、起始座標與影像來源。
檔案打包下載:https://www.jb51.net/jiaoben/24767.html