DIV CSS 佈局教程網

用 zepto.js 打造手機版大圖瀏覽元件 ImageView.js
編輯:JavaScript綜合知識     

手機版的相簿需要能左右滑動切換、雙指縮放、雙擊放大,還要在放大後拖曳平移。這些手勢用原生事件實作相當繁瑣,這個元件以 zepto.js(相容 jQuery 語法、體積小適合行動裝置)為基礎,把整套互動封裝成一個 ImageView(index, imgData) 函式。

呼叫方式

ImageView(index, imgData);
// index   預設顯示的圖片索引,Number
// imgData 圖片網址陣列,Array

使用前需先引入 zepto.js。

主程式

/*
 * ImageView v1.0.0
 * --基於 zepto.js 的大圖查看
 * --調用方法 ImageView(index, imgData)
 * --index 圖片默認顯示索引, Number
 * --imgData 圖片 url 數組, Array
 * */
var ImageView = (function(window, $){
  var _this = $("#slideView"), _ImgData = [], _index = 0, _length = 0,
      _start = [], _org = [], _orgTime = null,
      _lastTapDate = null,
      _zoom = 1, _zoomXY = [0, 0], _transX = null,
      _advancedSupport = false,
      _doubleDistOrg = 1, _doubleZoomOrg = 1, isDoubleZoom = false,
      isSlide = true, isDrag = false, timer = null,
      winW = window.innerWidth, winH = window.innerHeight;

var Event = {
  touchstart: function(e){
    e.preventDefault();
    // 雙指:記錄起始距離與倍率
    if (_advancedSupport && e.touches && e.touches.length >= 2) {
      var img = getImg();
      $(img).css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"});
      _doubleZoomOrg = _zoom;
      _doubleDistOrg = getDist(e.touches[0].pageX, e.touches[0].pageY,
                               e.touches[1].pageX, e.touches[1].pageY);
      isDoubleZoom = true;
      return;
    }
    e = e.touches ? e.touches[0] : e;
    isDoubleZoom = false;
    _start = [e.pageX, e.pageY];
    _org   = [e.pageX, e.pageY];
    _orgTime = Date.now();
    _transX = -_index * winW;

    if (_zoom != 1) {
      _zoomXY = _zoomXY || [0, 0];
      _orgZoomXY = [_zoomXY[0], _zoomXY[1]];
      var img = getImg();
      img && ($(img).css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"}));
      isDrag = true;
    } else {
      _this.find(".pv-inner").css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"});
      isSlide = true;
    }
  },

  touchmove: function(e){
    e.preventDefault();
    // 雙指縮放
    if (_advancedSupport && e.touches && e.touches.length >= 2) {
      var newDist = getDist(e.touches[0].pageX, e.touches[0].pageY,
                            e.touches[1].pageX, e.touches[1].pageY);
      _zoom = (newDist / _doubleDistOrg) * _doubleZoomOrg;
      var img = getImg();
      $(img).css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"});
      if (_zoom < 1) {
        _zoom = 1;
        _zoomXY = [0, 0];
        $(img).css({"-webkit-transitionDuration":"200ms","transitionDuration":"200ms"});
      } else if (_zoom > getScale(img) * 2) {
        _zoom = getScale(img) * 2;
      }
      $(img).css({
        "-webkit-transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)",
        "transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)"
      });
      return;
    }
    if (isDoubleZoom) { return; }

    e = e.touches ? e.touches[0] : e;

    if (_zoom != 1) {
      // 放大狀態:拖曳平移,超出邊界時阻尼衰減
      var deltaX = (e.pageX - _start[0]) / _zoom;
      var deltaY = (e.pageY - _start[1]) / _zoom;
      _start = [e.pageX, e.pageY];

      var img = getImg();
      var newWidth = img.clientWidth * _zoom,
          newHeight = img.clientHeight * _zoom;
      var borderX = (newWidth - winW) / 2 / _zoom,
          borderY = (newHeight - winH) / 2 / _zoom;

      (borderX >= 0) && (_zoomXY[0] < -borderX || _zoomXY[0] > borderX) && (deltaX /= 3);
      (borderY > 0)  && (_zoomXY[1] < -borderY || _zoomXY[1] > borderY) && (deltaY /= 3);

      _zoomXY[0] += deltaX;
      _zoomXY[1] += deltaY;

      (_length == 1 && newWidth < winW || newWidth < winW)   && (_zoomXY[0] = 0);
      (_length == 1 && newHeight < winH || newHeight < winH) && (_zoomXY[1] = 0);

      $(img).css({
        "-webkit-transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)",
        "transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)"
      });
    } else {
      // 正常狀態:左右滑動換圖
      if (!isSlide) { return; }
      var deltaX = e.pageX - _start[0];
      (_transX > 0 || _transX < -winW * (_length - 1)) && (deltaX /= 4);
      _transX = -_index * winW + deltaX;
      _this.find(".pv-inner").css({
        "-webkit-transform": "translate(" + _transX + "px,0px) translateZ(0)"
      });
    }
  },

  touchend: function(e){
    if (isDoubleZoom) { return; }

    if (_zoom != 1) {
      if (!isDrag) { return; }
      var img = getImg();
      var newWidth = img.clientWidth * _zoom,
          newHeight = img.clientHeight * _zoom;
      var borderX = (newWidth - winW) / 2 / _zoom,
          borderY = (newHeight - winH) / 2 / _zoom;

      // 拖曳超過門檻時切換到上一張或下一張
      if (_length > 1 && borderX >= 0) {
        var updateDelta = 0, switchDelta = winW / 6;
        if (_zoomXY[0] < -borderX - switchDelta / _zoom && _index < _length - 1) {
          updateDelta = 1;
        } else if (_zoomXY[0] > borderX + switchDelta / _zoom && _index > 0) {
          updateDelta = -1;
        }
        if (updateDelta != 0) {
          scaleDown(img);
          changeIndex(_index + updateDelta);
          return;
        }
      }

      // 依停留時間套用慣性或使用阻尼回彈
      var delta = Date.now() - _orgTime;
      if (delta < 300) {
        (delta <= 10) && (delta = 10);
        var deltaDis = Math.pow(180 / delta, 2);
        _zoomXY[0] += (_zoomXY[0] - _orgZoomXY[0]) * deltaDis;
        _zoomXY[1] += (_zoomXY[1] - _orgZoomXY[1]) * deltaDis;
        $(img).css({"-webkit-transition":"400ms cubic-bezier(0.08,0.65,0.79,1)",
                    "transition":"400ms cubic-bezier(0.08,0.65,0.79,1)"});
      } else {
        $(img).css({"-webkit-transition":"200ms linear","transition":"200ms linear"});
      }

      if (borderX >= 0) {
        if (_zoomXY[0] < -borderX) { _zoomXY[0] = -borderX; }
        else if (_zoomXY[0] > borderX) { _zoomXY[0] = borderX; }
      }
      if (borderY > 0) {
        if (_zoomXY[1] < -borderY) { _zoomXY[1] = -borderY; }
        else if (_zoomXY[1] > borderY) { _zoomXY[1] = borderY; }
      }

      if (Math.abs(_zoomXY[0]) < 10) {
        $(img).css({"-webkit-transform": "scale(" + _zoom + ") translate(0px," + _zoomXY[1] + "px)",
                    "transform": "scale(" + _zoom + ") translate(0px," + _zoomXY[1] + "px)"});
        return;
      } else {
        $(img).css({"-webkit-transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)",
                    "transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)"});
      }
      isDrag = false;
    } else {
      if (!isSlide) { return; }
      var deltaX = _transX - (-_index * winW);
      var updateDelta = 0;
      if (deltaX > 50)       { updateDelta = -1; }
      else if (deltaX < -50) { updateDelta = 1; }
      _index = _index + updateDelta;
      changeIndex(_index);
      isSlide = false;
    }
  },

  click: function(e){
    _zoom = 1;
    _zoomXY = [0, 0];
    _this.css("opacity", "0");
    timer = setTimeout(function(){
      _this.css({"display":""}).html("");
      unbind();
    }, 150);
  },

  dobelTap: function(e){
    clearTimeout(timer);
    var now = new Date;
    if (now - _lastTapDate < 500) { return; }
    _lastTapDate = now;
    var img = getImg();
    if (!img) { return; }
    if (_zoom != 1) { scaleDown(img); } else { scaleUp(img); }
  },

  setView: function(e){
    winW = window.innerWidth;
    winH = window.innerHeight;
    _this.width(winW).height(winH);
    translate((-_index * winW), 0, 0, $(".pv-inner")[0]);
    scaleDown(getImg());
  }
};

var handleEvent = function(e){
  switch (e.type){
    case "touchstart":  Event.touchstart(e);  break;
    case "touchmove":   Event.touchmove(e);   break;
    case "touchcancel":
    case "touchend":    Event.touchend(e);    break;
    case "orientationchange":
    case "resize":      Event.setView(e);     break;
  }
};

/** 綁定事件 */
var bind = function(){
  _this.on("singleTap", function(e){
    e.preventDefault();
    var now = new Date;
    if (now - _lastTapDate < 500) { return; }
    _lastTapDate = now;
    Event.click(e);
    return false;
  }).on("doubleTap", function(e){
    e.preventDefault();
    Event.dobelTap(e);
    return false;
  });

  _this.on("touchstart touchmove touchend touchcancel", function(e){
    handleEvent(e);
  });

  Event.setView();
  "onorientationchange" in window
    ? window.addEventListener("orientationchange", Event.setView, false)
    : window.addEventListener("resize", Event.setView, false);
};

/** 解除事件 */
var unbind = function(){
  _this.off();
  "onorientationchange" in window
    ? window.removeEventListener("orientationchange", Event.setView, false)
    : window.removeEventListener("resize", Event.setView, false);
};

var getDist = function(x1, y1, x2, y2){
  return Math.sqrt(Math.pow(x2 - x1, 2) + Math.pow(y2 - y1, 2), 2);
};

/** 圖片縮放倍率計算 */
var getScale = function(img){
  var h = img.naturalHeight, w = img.naturalWidth,
      Scale = w * h / (img.clientHeight * img.clientWidth);
  return Scale;
};

var scaleUp = function(img){
  var scale = getScale(img);
  if (scale > 1)
    $(img).css({"-webkit-transform": "scale(" + scale + ")",
                "transform": "scale(" + scale + ")",
                "-webkit-transition": "200ms", "transition": "200ms"});
  _zoom = scale;
};

var scaleDown = function(img){
  _zoom = 1;
  _zoomXY = [0, 0];
  _doubleDistOrg = 1;
  _doubleZoomOrg = 1;
  $(img).css({"-webkit-transform": "scale(1)", "transform": "scale(1)",
              "-webkit-transition": "200ms", "transition": "200ms"});
};

/** 位移 */
var translate = function(distX, distY, speed, ele){
  if (!!ele) { ele = ele.style; } else { return; }
  ele.webkitTransitionDuration = ele.MozTransitionDuration = ele.msTransitionDuration =
    ele.OTransitionDuration = ele.transitionDuration = speed + 'ms';
  ele.webkitTransform = 'translate(' + distX + 'px,' + distY + 'px) translateZ(0)';
  ele.msTransform = ele.MozTransform = ele.OTransform =
    'translateX(' + distX + 'px) translateY(' + distY + 'px)';
};

/** 更改索引 */
var changeIndex = function(index, force){
  if (index < 0) { index = 0; }
  else if (index >= _length) { index = _length - 1; }
  _index = index;
  translate((-_index * window.innerWidth), 0, force ? "0" : "200", $(".pv-inner")[0]);
  $("#J_index").html(_index + 1 + "/" + _length);
  imgLoad();
};

/** 取得目前圖片元素 */
var getImg = function(index){
  var img = _this.find("li").eq(index || _index).find("img");
  if (img.size() == 1) { return img[0]; } else { return null; }
};

/** 圖片載入 */
var imgLoad = function(){
  if ($(".pv-img").eq(_index).find("img")[0]) {
    $("#J_loading").css("display", "");
    return;
  } else {
    $("#J_loading").css("display", "block");
    var tempImg = new Image();
    tempImg.src = _ImgData[_index];
    $(".pv-img").eq(_index)[0].appendChild(tempImg);
    tempImg.onload = function(){ $("#J_loading").css("display", ""); };
  }
};

/** 建立 DOM 結構 */
var Create = function(){
  _this.append("<ul class='pv-inner'></ul>")
       .append("<p class='counts'><span class='value' id='J_index'>" +
               (_index + 1) + "/" + _length + "</span></p>")
       .append("<span class='ui-loading' id='J_loading'><i class='t1'></i>" +
               "<i class='t2'></i><i class='t3'></i></span>");
  for (var i = 0; i < _length; i++){
    $(".pv-inner").append("<li class='pv-img'></li>");
  }
  imgLoad();
};

/** 初始化 */
var init = function(){
  !!_this[0] || $("body").append("<div class='slide-view' id='slideView'></div>");
  _this = $("#slideView");
  ($.os.iphone || $.os.android && parseFloat($.os.version) >= 4) && (_advancedSupport = true);
}();

/** 對外介面 */
var ImageView = function(index, data){
  _ImgData = data;
  _index = index;
  _length = data.length;
  Create();
  _this.css("display", "block");
  bind();
};

return ImageView;
})(window, Zepto);

CSS

/* 大圖查看 */
.slide-view {
  background:#000; position:fixed; width:100%; height:100%; overflow:hidden;
  top:0; left:0; z-index:100; opacity:0; display:none;
  -webkit-animation:fadeIn .2s linear forwards;
  animation:fadeIn .2s linear forwards;
  -webkit-touch-callout:none; -webkit-transform-style:preserve-3d;
}
.slide-view .counts {
  position:absolute; top:5%; left:0; right:0; text-align:center; font-size:0;
  -webkit-transform-style:preserve-3d;
}
.slide-view .counts .value {
  border-radius:9px; line-height:18px; padding:0 6px; font-size:11px;
  display:inline-block; background-color:rgba(102,102,102,.6); color:#f1f1f1;
}
.pv-inner {
  position:relative; z-index:-1; display:-webkit-box; display:box;
  width:100%; height:100%; -webkit-transition:all 350ms linear;
  -webkit-backface-visibility:hidden; transition:all 350ms linear;
  backface-visibility:hidden; -webkit-touch-callout:none;
  -webkit-transform-style:preserve-3d;
}
.pv-inner li {
  text-align:center; display:-webkit-box; display:box;
  -webkit-box-align:center; overflow:hidden; width:100%; height:100%;
  -webkit-touch-callout:none; backface-visibility:hidden;
  -webkit-transform-style:preserve-3d;
}
.pv-inner img {
  max-width:97%; max-height:100%;
  -webkit-transform:scale(1) translate(0px,0px);
  transform:scale(1) translate(0px,0px);
  visibility:visible; -webkit-transition:200ms; transition:200ms;
  -webkit-user-select:none; user-select:none; display:block; margin:0 auto;
  backface-visibility:hidden; -webkit-transform-style:preserve-3d;
}
@-webkit-keyframes fadeIn { 0%{opacity:0;} 100%{opacity:1;} }
@keyframes fadeIn { 0%{opacity:0;} 100%{opacity:1;} }

/* loading */
.ui-loading {
  position:absolute; left:50%; top:50%; display:none;
  vertical-align:middle; font:0/0 arial; margin:-5px 0 0 -10px;
}
.ui-loading i {
  display:inline-block; width:5px; height:12px; background:#fff;
  vertical-align:top; -webkit-animation:loading-spin 1s infinite linear;
  animation:loading-spin 1s infinite linear;
}
.ui-loading i.t2 { margin:0 3px; -webkit-animation-name:loading-spin-one; animation-name:loading-spin-one }
.ui-loading i.t3 { -webkit-animation-name:loading-spin-two; animation-name:loading-spin-two }

@-webkit-keyframes loading-spin {
  0%{opacity:0} 30%{opacity:1; -webkit-transform:scale(1,1.2)}
  60%{opacity:0; -webkit-transform:scale(1)} 100%{opacity:0}
}
@-webkit-keyframes loading-spin-one {
  0%{opacity:0} 20%{opacity:0} 50%{opacity:1; -webkit-transform:scale(1,1.2)}
  80%{opacity:0; -webkit-transform:scale(1)} 100%{opacity:0}
}
@-webkit-keyframes loading-spin-two {
  0%{opacity:0} 40%{opacity:0} 70%{opacity:1; -webkit-transform:scale(1,1.2)}
  100%{opacity:0; -webkit-transform:scale(1)}
}
@keyframes loading-spin {
  0%{opacity:0} 30%{opacity:1; transform:scale(1,1.2)}
  60%{opacity:0; transform:scale(1)} 100%{opacity:0}
}
@keyframes loading-spin-one {
  0%{opacity:0} 20%{opacity:0} 50%{opacity:1; transform:scale(1,1.2)}
  80%{opacity:0; transform:scale(1)} 100%{opacity:0}
}
@keyframes loading-spin-two {
  0%{opacity:0} 40%{opacity:0} 70%{opacity:1; transform:scale(1,1.2)}
  100%{opacity:0; transform:scale(1)}
}

使用範例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no">
<title>移動端大圖查看</title>
<script type="text/javascript" src="test_files/zepto.min.js"></script>
<script type="text/javascript" src="test_files/ImageView.js"></script>
</head>
<body>
<script>
;(function(){
  // 取得 html 中的圖片元素
  var aImg = document.querySelectorAll("img"),
      aImgSrc = [];

  for (var i = 0, l = aImg.length; i < l; i++){
    aImg[i].index = i;
    aImg[i].className += " conPic";
    aImgSrc.push(aImg[i].src);
  }

  // 等圖片載入完成後才綁定 tap,避免點擊時拿到錯誤尺寸
  for (var i = 0; i < $(".conPic").length; i++){
    if ($(".conPic")[i].complete) {
      addTap($(".conPic")[i]);
    } else {
      $(".conPic")[i].onload = function(){ addTap(this); };
    }
  }

  function addTap(obj){
    $(obj).on("tap", function(){
      ImageView($(obj)[0].index, aImgSrc);   // 呼叫元件
    });
  }
})();
</script>
</body>
</html>

幾個值得學習的互動細節

縮放倍率的計算:getScale() 用「原圖面積 ÷ 顯示面積」開根號的概念估算可放大倍率(原圖的 naturalWidth/Height 對照 clientWidth/Height),並限制最大只能放大到兩倍,避免糊成一片。

慣性與阻尼:touchend 裡用 Date.now() - _orgTime 判斷手指停留多久——小於 300 毫秒視為快速滑動,套用 Math.pow(180/delta, 2) 這個衰減係數讓位移多跑一段(慣性);反之則用較短的 linear 過渡慢慢回位。超出邊界時 deltaX /= 3 則是橡皮筋阻尼的手感來源。

放大狀態下也能換圖:當拖曳位移超過 winW / 6 且已到邊界,就先把圖縮回再切換索引。這個細節讓放大檢視時不必先縮小才能翻下一張。

單擊與雙擊的判定:靠 _lastTapDate 記錄上次點擊時間,500 毫秒內的第二次視為雙擊。單擊的回呼裡也做了同樣的時間檢查,避免雙擊時誤觸發關閉。

圖片延遲載入:imgLoad() 只載入目前這張,切換時才抓下一張,並顯示三個跳動小方塊組成的 loading 動畫(loading-spin 那三組 keyframes 用延遲相位製造波浪感)。

這份程式碼的時代痕跡與可改善處

作者自己也在結尾註明「程式碼功能比較簡單,可能會存在諸多問題」,的確有幾點值得注意。

其一,大量使用 -webkit- 前綴與 -webkit-box 這套舊版彈性盒模型,在當年是為了相容舊版 iOS/Android,如今應改用標準的 display: flex。

其二,touchstart/touchmove 裡呼叫 e.preventDefault() 是為了阻止頁面跟著滾動,但這也讓該元素上的原生滾動完全失效;現代做法是用 CSS 的 touch-action: none 達到相同效果,且不會影響效能(在部分瀏覽器上,事件監聽器若不宣告 passive: false,preventDefault 是會被忽略的)。

其三,img.size() 已在 jQuery 3.0 移除,應改用 .length。

其四,元件狀態全放在閉包的私有變數裡,代表同一頁只能有一個實例;若要支援多組,需改寫為建構函式並把狀態掛在 this 上。

最後,現今若要實作同樣的功能,直接用成熟的函式庫(如 PhotoSwipe、lightGallery)會省下大量時間,它們在無障礙、鍵盤操作與效能上都處理得更完整。這份原始碼的價值在於完整展示了手勢處理的每一個環節,讀懂它之後再使用函式庫,遇到客製需求時會更有底氣。

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