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

以正方形圖片為例,需要四個元素:圖片容器、原圖、遮罩塊(代表放大的區域)、以及承載大圖的容器與大圖本身。
/* 圖片容器 */
.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。
<!-- 圖片容器 -->
<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>
(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);
});
})()
順帶整理幾個實用的基礎知識
回傳元素的大小及其相對於視窗的位置。因為它給的是即時值,所以必須放在 mousemove 這類高頻事件裡呼叫,不能提前在初始化時算好——頁面一捲動,數值就過期了。
這個方法也很好用來實作「捲到頂或底時觸發事件」,比一堆 offsetTop 加總可靠得多。
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 阻止事件在捕獲與冒泡階段的進一步傳播。
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 或參數讀取,否則調整尺寸時很容易漏改一處。
後來也把這個效果整理成了設定更簡便的版本,需要的人可以參考。