這幾天抽空為項目做了一個量身定制的圖片查看器,目前初步滿足需求。
業務場景是:在一個多文件下載列表中,判斷到某項是圖片時,點擊它打開查看器展示大圖,同時把列表內其他圖片一并納入查看隊列,支持前後滑動與附帶操作。
聽著任務不少,拆開看其實很清晰:
1)拿到被點擊的圖片對象,以及符合條件的圖片集合;
2)查看器的繪製與圖片隊列展示;
3)圖片的友好加載方式;
4)觸摸滑動以及滑動後的連鎖行為。
第一步,給列表中的圖片鏈路打上統一標識。文件是不是圖片、地址是什麼,在存儲時就已知,直接掛一個自定義屬性即可:
<a url="..."></a>
第二步,準備全屏遮罩與隊列容器,並以 NO./N 的形式標註當前位置。樣式一次性給出(其中 figure 的幾個屬性是 swipe.js 必需的):
.dialog,.dialog figure{position:fixed;top:0;bottom:0;left:0;right:0;z-index:1001;}
.dialog section{height:100%;background:#333;-webkit-opacity:0.7;}
.dialog footer{padding:10px;position:absolute;bottom:0;left:0;right:0;z-index:1002;font-size:13px;}
.dialog footer span{padding:0 20px;float:right;border:1px solid #999;border-radius:15px;color:#ddd;}
.dialog figure{overflow:hidden;}
.dialog figure ul{height:100%;overflow:hidden;}
.dialog figure li{width:100%;height:100%;display:-webkit-box;float:left;position:relative;-webkit-box-pack:center;-webkit-box-align:center;}
.dialog figure img{max-width:100%;max-height:100%;margin:10px;}
第三步,先渲染 loading 佔位圖,真圖後續動態替換:
<img src="loading.gif" url="..." />
第四步,接入 swipe.js 這個輕量級觸摸滑動插件:
var obj = document.getElementById('swipe');
window.mySwipe = Swipe(obj, { ... });
可配置參數:
startSlide: 0, // 起始位置
auto: 3000, // 自動播放間隔
continuous: true, // 是否無限循環;項數不確定時建議設 false
disableScroll: false, // 觸摸時禁止滾屏
callback: function (index, element) {}, // 滑動中回調
transitionEnd: function (index, element) {} // 滑動結束回調
API 方法:
prev(); // 上一頁 next(); // 下一頁 getPos(); // 當前頁索引 getNumSlides(); // 總項數 slide(index, duration); // 跳轉並播放動畫
必需的 HTML 與 CSS 結構:
<figure id="swipe"><ul><li></li></ul></figure>
figure{overflow:hidden;position:relative;}
figure ul{overflow:hidden;}
figure li{width:100%;float:left;position:relative;}
無論體積還是文檔它都很輕巧,上手極快。
1. 統一事件入口,判斷 url 屬性是否存在,存在則打開查看器並阻止後續跳轉:
$('.download a').click(function () {
var obj = $(this);
var url = obj.attr('url');
if (url && url.length > 0) {
var set = $('.download a[url]');
base_module.dialog(obj, set);
return false;
}
// ... 其他下載邏輯
});
2. 約定模塊結構,後續方法都掛在這個對象上:
var base_module = (function () {
var base = {};
base.options = { LOCK: false };
return base;
})();
3. 查看器主函數,負責繪製容器、渲染隊列、按需載入腳本與首圖:
/**
* 圖片查看器
* @param object obj 操作對象
* @param object set 對象集
*/
base.dialog = function (obj, set) {
var i = set.index(obj); // 當前頁索引
var rel = set.length; // 總項數
var html = '<section class="dialog"><section></section><figure id="swipe"><ul>';
set.each(function () {
var url = $(this).attr('url');
html += '<li><img src="loading.gif" width="40" height="40" url="' + url + '" /></li>';
});
html += '</ul></figure><footer><span id="po">' + (i + 1) + '/' + rel + '</span></footer></section>';
$('body').append(html);
base.loadJs('swipe.min.js', function () { base.swiper(i); });
var url = obj.attr('url');
base.loadImg(url, function () { base.imager(i); });
};
4. 按需加載 JS,避免重複插入 script:
base.loadJs = function (url, fn) {
if (typeof Swipe != 'undefined') { if (fn) fn(); return false; }
var js = document.createElement('script');
js.src = url;
document.getElementsByTagName('head')[0].appendChild(js);
js.onload = function () { if (fn) fn(); };
};
5. 配置 swipe 並同步位置指示:
base.swiper = function (i) {
var obj = document.getElementById('swipe');
window.mySwipe = Swipe(obj, {
startSlide: i,
continuous: false,
disableScroll: true,
callback: function (index, element) {
$('#po').text((index + 1) + '/' + $('#swipe li').length);
var url = $(element).find('img').attr('url');
base.loadImg(url, function () { base.imager(index); });
}
});
};
6. 按需加載圖片,已緩存的走 complete 分支直接返回:
base.loadImg = function (url, fn) {
var img = new Image();
img.src = url;
if (img.complete) { if (fn) fn(); return false; }
img.onload = function () { if (fn) fn(); };
};
7. 加載完成後替換佔位圖:
base.imager = function (i) {
var obj = $('#swipe li').eq(i).find('img');
var url = obj.attr('url');
obj.replaceWith('<img src="' + url + '" />');
};
目前只是初步完工,還有幾處值得改進:
其一,查看器關閉時應隱藏而非刪除節點;再次調用時若圖片列表未變化,直接喚醒即可,不必重新繪製。
其二,圖片不支持縮放,長寬比例極端時預覽效果很差。
其三,缺少縮略圖——開發時才發現存儲環節沒有做壓縮,加載流量開銷偏高,這個問題最終要在後台上傳時解決。
以上就是本文的全部內容,希望對大家的學習有所幫助。