當你要在網頁上展示一張尺寸遠大於視窗的圖片(世界地圖、建築平面圖、產品爆炸圖)時,讓使用者能用滑鼠拖著看,體驗會好很多。SpryMap 就是這樣一個輕量的 JavaScript 元件,能做到近似 Google、百度地圖的拖動效果。
它的客製性也不錯:可以設定圖片的起始位置、寬高、CSS 樣式,還能選擇是否啟用平滑拖曳。
<script type="text/javascript" src="spryMap-min2.js"></script>
給 img 標籤一個 id,這個 id 稍後會用在初始化時:
<img id="worldMap" src="map.jpg" />
var map = new SpryMap({
id : "worldMap",
height : 400,
width : 800,
startX : 200,
startY : 200,
cssClass : "mappy"
});
id:目標 img 的元素 id。width / height:可视區域(viewport)的寬高,也就是使用者實際看得到的框。startX / startY:初始顯示位置,決定載入時視圖停在圖片的哪個座標。cssClass:套用於容器上的樣式類別,方便你做邊框、陰影或游標樣式。這類元件的核心原理並不複雜:把圖片放在一個 overflow: hidden 的容器裡,然後監聽 mousedown、mousemove、mouseup 三個事件,依滑鼠位移量調整圖片的 left / top,就能達到拖動瀏覽的效果。若要平滑,則在放開滑鼠後加上過渡或加速度衰減。
transform: translate3d() 而非 left/top,前者能走 GPU 合成,動畫更順。touchstart / touchmove,或直接使用 Pointer Events 統一輸入來源。