DIV CSS 佈局教程網

微信JS-SDK預覽圖片與相冊選圖介面的完整用法
編輯:關於JavaScript     

在微信網頁裡做圖片展示,「點圖放大」和「從相冊選圖」是兩個必備能力。JS-SDK 1.0 提供了 previewImage 與 chooseImage 兩個介面,但它們有幾個不太直觀的限制,本文逐一說明。

一、previewImage:預覽圖片

使用前請先記住三點:

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 是整個可左右滑動的清單,兩者要對得上,否則會出現「進去時高亮的是別張圖」的錯亂。

二、chooseImage:從拍照或相冊選圖

這個介面有兩個重點:回傳的是 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 會拿到原始尺寸的大檔,行動網路下上傳前建議先壓縮,兼顧流量與速度。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved