DIV CSS 佈局教程網

原生 JS 實作商品詳情頁的圖片放大鏡
編輯:JavaScript技巧     

專案需要,用原生 JavaScript 寫了一個詳情頁的圖片放大鏡,程式碼記錄如下,也當作日常筆記。

效果預覽:

從 CSS 開始拆解

以正方形圖片為例,需要四個元素:圖片容器、原圖、遮罩塊(代表放大的區域)、以及承載大圖的容器與大圖本身。

/* 圖片容器 */
.imgBox {
  width: 200px;      /* 依實際需求調整 */
  height: 200px;
  position: relative; /* 必須,作為絕對定位的參照 */
}

/* 原圖 */
.mainImg {
  width: 100%;
  height: 100%;
}

/* 遮罩層,也就是被放大的區域 */
.glass {
  position: absolute; /* 必須 */
  width: 50px;        /* 放大 4 倍,故 200 / 4 = 50 */
  height: 50px;
  top: -9999px;       /* 先移出畫面外 */
  left: -9999px;
  cursor: move;
  background: rgba(0, 0, 180, 0.5);
}

/* 大圖容器 */
.imgMax {
  position: absolute; /* 必須 */
  overflow: hidden;   /* 必須,裁掉超出的部分 */
  left: 210px;        /* 距原圖左側 10px */
  top: 0;
  width: 200px;       /* 與原圖容器同尺寸 */
  height: 200px;
  display: none;      /* 初始隱藏 */
}

/* 大圖 */
.maxImg {
  position: absolute; /* 必須 */
  width: 800px;       /* 200 × 4 */
  height: 800px;
}

這裡唯一需要計算的就是縮放比例。遮罩尺寸 = 容器尺寸 ÷ 倍率,大圖尺寸 = 容器尺寸 × 倍率。若把 .imgMax 改成 400px,相當於再放大兩倍,那麼大圖就要相應改成 200 × 4 × 2 = 1600px。

HTML 結構

<!-- 圖片容器 -->
<div class="J_imgBox imgBox">
  <!-- 需要放大的原圖 -->
  <img class="J_mainImg mainImg" src="example.jpg" />
  <!-- 遮罩,代表放大區域 -->
  <div class="J_glass glass"></div>
  <!-- 大圖容器 -->
  <div class="J_imgMax imgMax">
    <img class="J_maxImg maxImg" />
  </div>
</div>

JavaScript 主體

(function(){
  /* 放大鏡
   * @imgContainer 要套用效果的圖片容器
   */
  function imgZoom(imgContainer){

    // 取得大圖網址:把縮圖檔名後的裁切參數去掉
    var imgUrl = imgContainer.querySelector('.J_mainImg').src
      .replace(/\.(jpg|jpeg|png|gif)(_)(\d+)(x)(\d+)(q90)?/g, '');

    var maxImg = imgContainer.querySelector('.J_maxImg');
    maxImg.src = imgUrl;

    var maxImgContainer = imgContainer.querySelector('.J_imgMax');
    var glassBlock = imgContainer.querySelector('.J_glass');

    // 取消放大
    var hideMaxImg = function(){
      glassBlock.style.top = '-9999px';
      glassBlock.style.left = '-9999px';
      maxImgContainer.style.display = 'none';
    };

    // 移出圖片區域即取消
    imgContainer.onmouseout = function(event){
      event.stopPropagation();
      hideMaxImg();
    };

    imgContainer.onmousemove = function(event) {
      event.stopPropagation();

      // 即時取得容器尺寸與其相對於視窗的位置
      var clientRect = event.currentTarget.getBoundingClientRect();

      var leftX = event.clientX - clientRect.left;
      var leftY = event.clientY - clientRect.top;

      // 讓遮罩中心對準游標,故各減去一半(50 / 2 = 25)
      var pointerLeft = leftX - 25;
      var pointerTop  = leftY - 25;

      // 游標若移出原圖範圍則取消。
      // 之所以需要這段,是因為快速滑過縫隙移到放大區時,
      // 游標其實還在外層容器內,mouseout 不會觸發
      if ((pointerLeft + 25) > clientRect.width || pointerLeft < -25 ||
          (pointerTop + 25) > clientRect.height || pointerTop < -25){
        hideMaxImg();
        return !1;
      }

      // 邊界夾住,避免遮罩跑出圖外
      if (pointerLeft < 0) pointerLeft = 0;
      if (pointerLeft > clientRect.width - 50) pointerLeft = clientRect.width - 50;
      if (pointerTop < 0) pointerTop = 0;
      if (pointerTop > clientRect.height - 50) pointerTop = clientRect.height - 50;

      glassBlock.style.left = pointerLeft;
      glassBlock.style.top = pointerTop;

      // 遮罩位置佔容器的比例,用來推算大圖的位移
      var percentLeft = pointerLeft / clientRect.width;
      var percentHeight = pointerTop / clientRect.height;

      // 大圖反向位移,因其父層有 overflow:hidden,只會露出對應區塊
      maxImg.style.left = -(percentLeft * maxImg.clientWidth) + 'px';
      maxImg.style.top  = -(percentHeight * maxImg.clientHeight) + 'px';
    };
  }

  var elem = document.querySelectorAll('.J_imgBox');
  elem.forEach(function(item){
    imgZoom(item);
  });
})()

順帶整理幾個實用的基礎知識

Element.getBoundingClientRect()

回傳元素的大小及其相對於視窗的位置。因為它給的是即時值,所以必須放在 mousemove 這類高頻事件裡呼叫,不能提前在初始化時算好——頁面一捲動,數值就過期了。

這個方法也很好用來實作「捲到頂或底時觸發事件」,比一堆 offsetTop 加總可靠得多。

event.target 與 event.currentTarget

target 指向觸發事件的元素,currentTarget 指向綁定監聽器的元素。只有兩者是同一個物件時,它們才相等。

document.getElementById('aDiv').addEventListener('click', function(e){
  console.log(e.target === e.currentTarget);
  console.log('target', e.target);
  console.log('currentTarget', e.currentTarget);
}, false);

點擊子元素 bDiv 時,target 是 bDiv,currentTarget 是 aDiv;點擊 aDiv 自身的文字時,兩者相同。事件委派正是靠這個特性運作的。

preventDefault 與 stopPropagation

preventDefault 取消元素的預設行為(例如連結跳轉、表單送出),但不影響事件繼續傳遞。

stopPropagation 阻止事件在捕獲與冒泡階段的進一步傳播。

stopImmediatePropagation 除了阻止傳播,還會一併取消同一元素上其餘同類型的監聽器。

document.getElementById('aDiv').addEventListener('click', function(){
  console.log('click aDiv');
}, false);
document.getElementById('bDiv').addEventListener('click', function(e){
  e.stopImmediatePropagation();
  console.log('click bDiv');
}, false);
document.getElementById('bDiv').addEventListener('click', function(){
  console.log('click me too');
}, false);

輸出只有 click bDiv。把 stopImmediatePropagation 註解掉,輸出會變成 click bDiv、click me too、click aDiv 三行。

補充

放大鏡的核心其實只有一個比例換算,其餘都是邊界處理。實作時最容易漏的是「快速滑過縫隙」那個 bug,它不會出現在一般的慢慢移動測試裡,卻會讓使用者覺得效果怪怪的。

另外提醒一個細節:程式中 25 這個數字是遮罩寬高的一半,屬於寫死的魔法值。若日後要讓遮罩尺寸可配置,記得改成由 computed style 或參數讀取,否則調整尺寸時很容易漏改一處。

後來也把這個效果整理成了設定更簡便的版本,需要的人可以參考。

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