Magic Zoom 是一個成熟的圖片放大鏡插件,適合電商商品頁、作品集等需要看細節的場景。本文整理它的引入方式、HTML 結構、參數與樣式設定。
一、引入檔案
<link type="text/css" rel="stylesheet" href="magiczoom.css"/>
<script type="text/javascript" src="magiczoom.js"></script>
二、HTML 結構
單圖結構(小圖 + 大圖)
<a href="big.jpg" class="MagicZoom">
<img src="small.jpg"/>
</a>
其中 class="MagicZoom" 是關鍵識別項,href 指向放大後要顯示的大圖。
多圖結構(小圖 + 中圖 + 大圖)
<!-- 主圖 -->
<a href="dbig.jpg" class="MagicZoom" id="rabbit">
<img src="small.jpg">
</a>
<!-- 附加圖 -->
<a href="addimg_big.jpg" rel="zoom-id:rabbit" rev="addimg_mid.jpg">
<img src="addimg_small.jpg"/>
</a>
<a href="addimg2_big.jpg" rel="zoom-id:rabbit" rev="addimg2_mid.jpg">
<img src="addimg2_small.jpg"/>
</a>
關聯方式:主圖加上 id 屬性,附加圖用 rev 指向中圖,再用 rel="zoom-id:rabbit" 建立與主圖的連結。
三、參數設定
參數寫在 rel 屬性裡,以分號分隔:
<a href="big.jpg" class="MagicZoom"
rel="zoom-width:118px; zoom-height:118px">
<img src="small.jpg"/>
</a>
特例:自訂放大框顯示位置
<a href="big.jpg" class="MagicZoom" id="elephant"
rel="zoom-position: custom">
<img src="small.jpg"/>
</a>
<div id="elephant-big"></div>
使用 custom 時,放大內容會渲染到 id 為「主圖 id + -big」的元素裡。
四、樣式自訂
直接在 magiczoom.css 中覆寫:
/* 放大顯示框 */
.MagicZoomBigImageCont {
border: none;
}
/* 抓取區域(跟著滑鼠移動的那塊) */
.MagicZoomPup {
border: 2px solid #658EC2;
background: #658EC2 url(dotted.png);
cursor: move;
}
五、參數對照表
Geometry 幾何相關
- zoom-width(預設 300):放大窗寬度,px
- zoom-height(預設 300):放大窗高度,px
- zoom-position(預設 right):right / left / top / bottom / inner / custom
- zoom-distance(預設 15):小圖與放大窗的間距,px
User experience 體驗相關
- opacity(預設 50,0-100):游標所在區域的透明度
- opacity-reverse(預設 false):滑鼠框外的區域加遮罩
- smoothing(預設 true):是否啟用平滑移動
- smoothing-speed(預設 40,1-99):平滑速度
- fps(預設 25):放大動畫的幀率
- show-title(預設 top):標題顯示位置,top / bottom / false
- zoom-fade(預設 false):淡入淡出效果
- zoom-fade-in-speed(預設 400):淡入速度,ms
- zoom-fade-out-speed(預設 200):淡出速度,ms
Multiple images 多圖切換
- thumb-change(預設 click):click 或 mouseover 切換
- selectors-mouseover-delay(預設 200):滑過後切換的延遲,ms
- selectors-effect(預設 dissolve):dissolve / fade / false
- selectors-effect-speed(預設 400):切換效果速度,ms
- preload-selectors-small(預設 true):預載縮圖
- preload-selectors-big(預設 false):預載大圖
Initialization 初始化
- click-to-initialize(預設 false):點擊後才抓取大圖
- click-to-activate(預設 false):點擊後才啟動放大
- show-loading(預設 true):顯示載入提示
- loading-msg(預設 "Loading zoom..."):提示文字
- loading-opacity(預設 75,0-100):提示透明度
- loading-position-x / y(預設 -1):提示位置,-1 為置中
Zoom mode 模式
- drag-mode(預設 false):按住拖曳移動放大窗
- move-on-click(預設 true):拖曳模式下點擊可移動
- preserve-position(預設 false):多圖與拖曳模式下記住位置
- x / y(預設 -1):拖曳模式的初始位置,-1 為置中
- always-show-zoom(預設 false):放大窗常駐顯示(drag-mode 下自動為 true)
- fit-zoom-window(預設 true):大圖比放大窗小時自動縮放視窗
- entire-image(預設 false):滑過時顯示完整大圖
實務建議:電商情境常用組合是 zoom-position: right; smoothing: true; entire-image: false;,並把 click-to-initialize 設為 true 以減少首屏載入量。