DIV CSS 佈局教程網

用 Zepto 打造仿手機 QQ 空間的大圖瀏覽元件 ImageView.js
編輯:關於JavaScript     

手機版的相簿幾乎都有同一套交互:點縮圖開啟黑底大圖檢視器、左右滑動換圖、雙擊放大、雙指縮放、放大後可拖曳、點空白處關閉。本文記錄一個以 zepto.js 實作的 ImageView 元件,把這些手勢都包起來,對外只暴露一個函式。

呼叫方式

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

使用前需先引入 zepto.js。

整體結構

元件包在一個立即執行函式中,內部維護狀態(目前索引 _index、總數 _length、縮放倍率 _zoom、位移 _zoomXY、滑動位移 _transX 等),對外只回傳 ImageView 函式,形成一個小型的閉包模組:

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;
  /* ... 事件、手勢、渲染、公開介面 ... */
  return ImageView;
})(window, Zepto);

手勢處理的四個入口

所有觸控邏輯集中在 Event 物件裡,分成 touchstart、touchmove、touchend 與 click/dobelTap 幾個部分。

touchstart 先判斷是否為雙指:若是,記錄兩指初始距離 _doubleDistOrg 與當前倍率 _doubleZoomOrg,並把 isDoubleZoom 旗標打開,後續 move/end 就直接走縮放分支。單指則記錄起點、時間與目前位移;若目前處於放大狀態就進入拖曳模式(isDrag),否則進入換圖滑動模式(isSlide)。

touchmove 的雙指分支用兩指距離的比例直接算新倍率:

var newDist = getDist(e.touches[0].pageX, e.touches[0].pageY,
                       e.touches[1].pageX, e.touches[1].pageY);
_zoom = (newDist / _doubleDistOrg) * _doubleZoomOrg;
if (_zoom < 1) { _zoom = 1; _zoomXY = [0, 0]; }          // 下限:不能縮小於原尺寸
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)"
});

單指分支再分兩種:放大狀態下改的是圖片的 translate,並對超出邊界的位移做阻尼(deltaX /= 3),讓使用者明確感到「到底了」;未放大時改的是整個 ul 的 translate,邊界處同樣除以 4 做橡皮筋效果。

touchend 負責「吸附」與「換圖」。放大狀態下會計算邊界 borderX/borderY,把位移夾回合法範圍;若滑動距離超過 winW/6 的門檻,就順勢切換到下一張。位移小於 300 毫秒的手快滑動還會套用不同曲線的 transition 做慣性收尾。未放大時則依 deltaX 是否超過 50 決定要不要換圖。

click / dobelTap 用 500 毫秒的時間窗來區分單擊與雙擊:單擊延遲 150 毫秒執行關閉(關閉時先淡出再清空 DOM 並解綁事件),雙擊則取消該計時器並在放大與還原之間切換。

縮放的基準:getScale

var getScale = function (img) {
  var h = img.naturalHeight, w = img.naturalWidth,
      Scale = w * h / (img.clientHeight * img.clientWidth);
  return Scale;
};

它用「原始面積 ÷ 目前顯示面積」估出圖片被壓縮的比例,雙擊放大時就放大到這個倍率,讓圖片以原始尺寸呈現。這比寫死 2 倍要準確,因為不同螢幕與 CSS 下的縮圖尺寸並不相同。

位移與換圖

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();
};

換圖的本質就是把 ul 往左推「索引 × 螢幕寬」,搭配 200 毫秒的 transition 就有滑動感。force 參數傳真時把速度設為 0,用於初始化或螢幕旋轉後的無動畫對齊。

按需載入與 loading

var imgLoad = function () {
  if ($(".pv-img").eq(_index).find("img")[0]) {
    $("#J_loading").css("display", "");
    return;
  }
  $("#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", ""); };
};

只有目前這張會真的建立 Image 並載入,滑到哪一張才抓哪一張,省流量也快。DOM 結構則在 Create() 中依 _length 動態產生對應數量的 li。

樣式

/* 大圖檢視 */
.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; width: 100%; height: 100%;
  -webkit-transition: all 350ms linear;
  transition: all 350ms linear;
  -webkit-backface-visibility: hidden; backface-visibility: hidden;
  -webkit-touch-callout: none;
  -webkit-transform-style: preserve-3d;
}
.pv-inner li {
  text-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;
  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; }

@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); }
}

三條豎線用不同的 keyframes 錯開相位,就得到「排隊閃爍」的加載動畫,不需要任何圖片。這裡的 -webkit-transform-style: preserve-3d 與 translate Z(0) 是為了觸發 GPU 合成層,讓縮放與滑動更順。

使用範例

<!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 src="zepto.min.js"></script>
  <script src="ImageView.js"></script>
</head>
<body>
<script>
;(function () {
  // 抓取頁面上所有圖片
  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);
  }

  // 圖片可能已載入完成,也可能還在下載,兩種情況都要綁事件
  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>

已知限制與改良方向

作者自己也提到功能相對簡單,還有許多可以打磨的地方。實測值得注意的幾點:

第一,_advancedSupport 只在 iPhone 或 Android 4.0 以上被設為真,其餘環境不會啟用雙指縮放,這在今天的行動裝置上顯得多餘,可以直接移除這個判斷。

第二,getScale 用面積比估算倍率,對「長寬比與容器差異很大」的極端尺寸圖片可能不夠精準,改用 naturalWidth / clientWidth 與 naturalHeight / clientHeight 取較小值會更穩。

第三,imgLoad 沒有 onerror 分支,圖片 404 時 loading 會一直轉。補上 onerror 顯示佔位圖是必須的。

第四,元件依賴 zepto 的 singleTap/doubleTap 事件。若專案已用 jQuery,可改用 pointer/touch 事件自行實作,或引入對應的 gesture 模組。

第五,DOM 以 innerHTML 拼接,若圖片網址來自使用者輸入,記得先檢查是否為可信來源。

整體來說,作為理解「手勢狀態機」的教材,這份程式把縮放、拖曳、換圖、慣性與按需載入的關係寫得很清楚,值得細讀。

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