在微信網頁裡做圖片展示,「點圖放大」和「從相冊選圖」是兩個必備能力。JS-SDK 1.0 提供了 previewImage 與 chooseImage 兩個介面,但它們有幾個不太直觀的限制,本文逐一說明。
使用前請先記住三點:
1. 預覽圖片介面目前只支援微信手機版;
2. 只支援 http 連結,weixin:// 開頭的本地資源無法預覽;
3. 圖片網址需要編碼處理,特別是路徑中含中文時,必須用 window.encodeURI()。
看起來好像沒差別,實際上差很多:
//1.預覽圖片 會顯示下載失敗
wx.previewImage({
current:'https://localhost/content/images/冰皮月餅.jpg',
urls:[ 'https://localhost/content/images/冰皮月餅.jpg' ]
});
//預覽圖片成功
wx.previewImage({
current:'https://localhost/content/images/%E5%86%B0%E7%9A%AE%E6%9C%88%E9%A5%BC.jpg',
urls:[ 'https://localhost/content/images/%E5%86%B0%E7%9A%AE%E6%9C%88%E9%A5%BC.jpg' ]
});
直接寫中文路徑會下載失敗,編碼後才正常。實務上通常會這樣動態組出清單:
var imgList = $('.row img');
var urlList = [];
imgList.each(function(){
var url = 'https://' + location.host + $(this).attr('src');
//對url中的中文進行處理
url = window.encodeURI(url);
urlList.push(url);
});
//1.預覽圖片介面目前只支援微信手機版
//2.預覽圖片只支援http連接,對於weixin:// 無法預覽
wx.previewImage({
current: urlList[0],
urls: urlList
});
current 是初次打開時顯示的那張,urls 是整個可左右滑動的清單,兩者要對得上,否則會出現「進去時高亮的是別張圖」的錯亂。
這個介面有兩個重點:回傳的是 localIds 陣列,每個 localId 形如 weixin://resourceid/xxxx,可以直接塞進 img 的 src;而這些 localId 目前只能用手機版顯示,PC 微信不可用。
選單張:
wx.chooseImage({
count: 1, // 默認9
sizeType: ['original', 'compressed'], // 可以指定是原圖還是壓縮圖,默認二者都有
sourceType: ['album', 'camera'], // 可以指定來源是相冊還是相機,默認二者都有
success: function (res) {
var localIds = res.localIds;
//返回選定照片的本地ID列表,localId可以作為img標簽的src屬性顯示圖片
$('#imgTarget').attr('src', localIds[0]);
}
});
選多張並動態組出縮圖牆:
wx.chooseImage({
count: 4,
sizeType:['original'],
sourceType:['album', 'camera'],
success:function(res){
var localIds = res.localIds;
for (var i = 0; i < localIds.length; i++) {
addImg(localIds[i]);
}
}
});
//添加圖片的row
function addImg(src){
var col = $('<div />');
col.addClass('col-xs-6 col-md-3');
var a = $('<a />');
a.addClass('thumbnail');
var img = $('<img />');
img.attr('src', src);
a.append(img).append(src);
col.append(a);
$('.row').append(col);
}
第一,localId 是臨時的,頁面重新整理後就失效。若要把使用者選的圖存到後端,通常得先上傳取得伺服器網址,再用該網址做後續處理。
第二,count 有上限(一般為 9),sizeType 選 original 會拿到原始尺寸的大檔,行動網路下上傳前建議先壓縮,兼顧流量與速度。