萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

基於 Zepto.js 的移動端大圖查看組件 ImageView.js:雙指縮放、左右滑動、雙擊縮放

組件能力

  • 單指左右滑動切換圖片(輪播)。
  • 雙指捏合縮放(Pinch Zoom)。
  • 雙擊放大/還原(2x 上限)。
  • 拖拽移動已縮放圖片。
  • 超過邊界彈性回彈、慣性滑動。
  • 極輕量,依賴 Zepto.js,適配移動端 WebView / 微信瀏覽器。

調用方式

// 引入 Zepto.js & ImageView.js
ImageView(index, imgArray);
// index: Number, 初始顯示圖片索引 (0-based)
// imgArray: Array[String], 圖片 URL 列表

// 示例
var images = [
    "https://example.com/img1.jpg",
    "https://example.com/img2.jpg",
    "https://example.com/img3.jpg"
];
ImageView(0, images); // 從第一張開始查看

核心架構 (ImageView.js 關鍵邏輯節選)

var ImageView = (function(window, $) {
    var $view = $("#slideView"),           // 容器 (需預置在 HTML)
        imgData = [], index = 0, length = 0,
        zoom = 1, zoomXY = [0,0], transX = 0,
        isDragging = false, isSliding = true,
        winW = window.innerWidth, winH = window.innerHeight;

    // 事件處理
    var Event = {
        touchstart: function(e) {
            // 多點觸控 -> 進入縮放模式
            if (e.touches && e.touches.length >= 2) {
                initPinchZoom(e); return;
            }
            // 單點 -> 準備拖拽或滑動
            startDragOrSlide(e);
        },
        touchmove: function(e) {
            if (isPinching) { handlePinchZoom(e); return; }
            if (zoom !== 1) { handleDragZoomed(e); }
            else { handleSlide(e); }
        },
        touchend: function(e) {
            if (isPinching) return;
            if (zoom !== 1) { handleDragEnd(e); }
            else { handleSlideEnd(e); }
        }
    };

    // 核心輔助函數
    function getImg() { return $view.find(".pv-slide").eq(index).find("img")[0]; }
    function getScale(img) { return Math.max(winW/img.naturalWidth, winH/img.naturalHeight); }
    function changeIndex(newIdx) { /* 切換索引、重置縮放、CSS transform 過渡 */ }
    function scaleDown(img) { /* 縮放回 1x、重置位移、過渡動畫 */ }

    // 公開 API
    return function(idx, data) {
        imgData = data; index = idx; length = data.length;
        render(); $view.show(); bindEvents();
    };
})(window, Zepto);

HTML 容器結構 (需預置)

<div id="slideView" style="display:none; position:fixed; top:0; left:0; width:100%; height:100%; background:#000; z-index:9999;">
    <div class="pv-inner" style="width:100%; height:100%; position:absolute; left:0; top:0;">
        <!-- 圖片由 JS 動態注入 -->
    </div>
</div>

關鍵交互細節

  1. 狀態機:isSliding / isDragging / isPinching 互斥,確保單指/多指操作不衝突。
  2. 邊界約束:縮放時計算 borderX = (放大後寬 - 視口寬) / 2 / zoom,限制 zoomXY 不超出邊界,超出施加 1/3 阻尼。
  3. 慣性滑動:touchend 計算速度 deltaDis = (180/deltaTime)^2,配合 cubic-bezier(0.08,0.65,0.79,1) 自然減速。
  4. 切圖閾值:縮放狀態下水平拖拽超過 winW/6 觸發切換上/下一張並自動復位。
  5. 性能:動畫期間設置 transitionDuration: 0ms 實時跟手;結束後恢復過渡動畫。

現代替代:PhotoSwipe / Viewer.js

若需更完整功能(分享、全屏、鍵盤、桌面端支持),建議使用成熟庫:

  • PhotoSwipe:純 JS、無依賴、極致性能。
  • Viewer.js:基於 jQuery/Zepto、功能豐富、易定制。
copyright © 萬盛學電腦網 all rights reserved