處理對應事件

本文說明如何使用地圖事件類別。 屬性會醒目提示地圖上事件及地圖的不同圖層。 您也可以在與 HTML 標記互動時醒目提示事件。

與地圖互動

對應事件範例會醒目提示當您與對應互動時所引發的事件名稱。 如需此範例的原始程式碼，請參閱對應事件原始程式碼。

與地圖圖層互動

圖層事件範例會醒目提示當您與符號圖層互動時所引發的事件名稱。 符號、泡泡圖、線條與多邊形圖層全都支援一組相同的事件。 熱度圖和圖格層不支援這些事件。 如需此範例的原始程式碼，請參閱圖層事件原始程式碼。

與 HTML 標記互動

HTML 標記圖層事件範例會醒目提示當您與 HTML 標記圖層互動時所引發的事件名稱。 如需此範例的原始程式碼，請參閱 HTML 標記圖層事件原始程式碼。

下表列出所有支援地圖類別事件。

事件	描述
boxzoomend	在「方塊縮放」互動結束時引發。
boxzoomstart	在「方塊縮放」互動開始時引發。
click	在地圖上相同點按下並放開指標裝置時引發。
close	以手動或程式設計方式關閉快顯視窗時引發。
contextmenu	按一下滑鼠右鍵時引發。
data	載入或變更任何地圖資料時引發。
dataadded	圖形新增至 DataSource 時引發。
dataremoved	圖形從 DataSource 中移除時引發。
datasourceupdated	更新 DataSource 物件時引發。
dblclick	在地圖上相同點按兩下指標裝置時引發。
drag	在地圖、快顯或 HTML 標記的「拖曳至平移」互動期間重複引發。
dragend	在地圖、快顯或 HTML 標記的「拖曳至平移」互動結束時引發。
dragstart	在地圖、快顯或 HTML 標記的「拖曳至平移」互動開始時引發。
error	發生錯誤時引發。
idle	在地圖進入「閒置」狀態之前最後一個轉譯的畫面之後引發： 沒有任何觀景窗正在轉換。 所有目前要求的圖格都已載入。 所有淡出或轉換動畫都已完成。
keydown	按下按鍵時引發。
keypress	按下會產生可鍵入字元 (ANSI 鍵) 的按鍵時引發。
keyup	釋放按鍵時引發。
layeradded	圖層新增至地圖時引發。
layerremoved	從地圖移除圖層時引發。
load	在已下載所有必要資源並已產生地圖的第一個視覺化完整轉譯之後，立即引發。
mousedown	在地圖內或在項目上方按下指標裝置時引發。
mouseenter	指標裝置開始在地圖或項目上移動時引發。
mouseleave	指標裝置移出地圖或項目時引發。
mousemove	指標裝置在地圖或項目內移動時引發。
mouseout	指標裝置離開地圖的畫布或離開項目時引發。
mouseover	指標裝置在地圖或項目上移動時引發。
mouseup	在地圖內或在項目上方放開指標裝置時引發。
move	在因使用者互動或方法的結果，而從某個檢視動態轉換到另一個檢視期間重複引發。
moveend	在地圖因使用者互動或方法的結果，而完成從某個檢視轉換至另一個檢視之後引發。
movestart	在地圖因使用者互動或方法的結果，而開始從某個檢視轉換到另一個檢視之前引發。
open	以手動或程式設計方式開啟快顯視窗時引發。
pitch	每當地圖因使用者互動或方法的結果，而變更傾斜度時引發。
pitchend	在地圖因使用者互動或方法的結果，而結束變更傾斜度之後立即引發。
pitchstart	每當地圖因使用者互動或方法的結果，而開始變更傾斜度時引發。
ready	當地圖已準備好以程式設計方式進行互動，以在載入最低的必要地圖資源時引發。
render	每當地圖因下列原因而繪製到畫面時引發： 變更地圖的位置、縮放、傾斜度或方位。 變更地圖的樣式。 變更 DataSource 來源。 載入向量圖格、GeoJSON 檔案、字符或原件。
resize	調整地圖大小之後立即引發。
rotate	在「拖曳至旋轉」互動期間重複引發。
rotateend	在「拖曳至旋轉」互動結束時引發。
rotatestart	在「拖曳至旋轉」互動開始時引發。
shapechanged	在變更圖形物件屬性時引發。
sourcedata	載入或變更其中一個地圖的來源 (包括屬於來源的圖格) 時引發。
sourceadded	DataSource 或 VectorTileSource 新增至地圖時引發。
sourceremoved	從地圖移除 DataSource 或 VectorTileSource 時引發。
styledata	載入或變更地圖的樣式時引發。
styleimagemissing	圖層嘗試從不存在的影像原件載入影像時引發
tokenacquired	取得 Microsoft Entra 存取權杖時引發。
touchcancel	在地圖內發生 touchcancel 事件時引發。
touchend	在地圖內發生 touchend 事件時引發。
touchmove	在地圖內發生 touchmove 事件時引發。
touchstart	在地圖內發生 touchstart 事件時引發。
wheel	在地圖內發生滑鼠滾輪事件時引發。
zoom	在因使用者互動或方法的結果，而從某個縮放層級動態轉換到另一個縮放層級期間重複引發。
zoomend	在地圖因使用者互動或方法的結果，而完成從某個縮放層級轉換至另一個縮放層級之後引發。
zoomstart	在地圖因使用者互動或方法的結果，而開始從某個縮放層級轉換至另一個縮放層級之後引發。

下一步

請參閱下列文章中的完整程式碼範例：

使用 Azure 地圖服務的服務模組

程式碼範例