Event system

event 類別

google.maps.event 類別

所有公開事件函式的命名空間

呼叫 const {event} = await google.maps.importLibrary("core") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
addListener
addListener(instance, eventName, handler)
參數： 
傳回值：  MapsEventListener
針對指定的物件實例，將特定的接聽函式新增至特定的事件名稱。傳回可用於 removeListener() 的此接聽程式識別碼。
addListenerOnce
addListenerOnce(instance, eventName, handler)
參數： 
傳回值：  MapsEventListener
功能和 addListener 相同，但在處理第一個事件後，處理常式會自行移除。
clearInstanceListeners
clearInstanceListeners(instance)
參數： 
傳回值：  void
針對特定實例移除所有事件的所有接聽程式。
clearListeners
clearListeners(instance, eventName)
參數： 
  • instance：Object
  • eventName：string
傳回值：  void
針對特定實例移除指定事件的所有接聽程式。
hasListeners
hasListeners(instance, eventName)
參數： 
  • instance：Object
  • eventName：string
傳回值：  boolean
如果指定實例上有特定事件的監聽器，則傳回 。可用來儲存昂貴事件的詳細資料。
removeListener
removeListener(listener)
參數： 
傳回值：  void
移除上方 addListener 應已傳回的特定事件監聽器。等同於呼叫 listener.remove()。
trigger
trigger(instance, eventName, eventArgs)
參數： 
  • instance：Object
  • eventName：string
  • eventArgs：...?
傳回值：  void
觸發指定事件。eventName 後面的所有引數會傳送成給接聽程式的引數。
addDomListener
addDomListener(instance, eventName, handler[, capture])
參數： 
  • instance：Object
  • eventName：string
  • handler：Function
  • capture：boolean optional
傳回值：  MapsEventListener
註冊跨瀏覽器事件處理常式。呼叫 removeListener(handle) 移除這個接聽程式，即可取得此函式傳回的處理權。
addDomListenerOnce
addDomListenerOnce(instance, eventName, handler[, capture])
參數： 
  • instance：Object
  • eventName：string
  • handler：Function
  • capture：boolean optional
傳回值：  MapsEventListener
addDomListener 周圍的包裝函式，會在第一個事件發生後移除接聽程式。

MapsEventListener 介面

google.maps.MapsEventListener 介面

由 google.maps.event.addListener() 和好友建立的事件監聽器。
remove
remove()
參數：無
傳回值：  void
移除事件監聽器。

呼叫 listener.remove() 等同於 google.maps.event.removeListener(listener)。

MVCObject 類別

google.maps.MVCObject 類別

實作 KVO 的基礎類別。

MVCObject 建構函式保證為空白函式，因此您可以編寫 MySubclass.prototype = new google.maps.MVCObject(); 來繼承 MVCObject 。除非另有註明，否則 API 中的其他類別並不適用此設定，且不支援從 API 中的其他類別繼承。

呼叫 const {MVCObject} = await google.maps.importLibrary("core") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
MVCObject
MVCObject()
參數：無
可建立 MVCObject。
addListener
addListener(eventName, handler)
參數： 
傳回值：  MapsEventListener
將指定的事件監聽器函式新增至指定的事件名稱。傳回可用於 google.maps.event.removeListener 的事件監聽器 ID。
bindTo
bindTo(key, target[, targetKey, noNotify])
參數： 
  • key：string
  • target：MVCObject
  • targetKey：string optional
  • noNotify：boolean optional
傳回值：無
將 View 連結至 Model。
get
get(key)
參數： 
  • key：string
傳回值：  ?
取得一個值。
notify
notify(key)
參數： 
  • key：string
傳回值：無
通知所有觀察者這個屬性的變動。這樣會同時通知連結至物件屬性的物件，以及它連結的物件。
set
set(key, value)
參數： 
  • key：string
  • value：*
傳回值：無
設定一個值。
setValues
setValues([values])
參數： 
傳回值：無
設定「按鍵值」對組的集合。
unbind
unbind(key)
參數： 
  • key：string
傳回值：無
移除連結。取消連結會將未連結的屬性設為目前值。物件不會收到通知，因為值未變更。
unbindAll
unbindAll()
參數：無
傳回值：無
移除所有連結。

MVCArray 類別

google.maps.MVCArray<T> 類別

這個類別會擴充 MVCObject。

呼叫 const {MVCArray} = await google.maps.importLibrary("core") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
MVCArray
MVCArray([array])
參數： 
  • array：Array<T> optional
易變的 MVC 陣列。
clear
clear()
參數：無
傳回值：無
移除陣列中的所有元素。
forEach
forEach(callback)
參數： 
  • callback：function(T, number): void
傳回值：無
反覆執行每個元素，呼叫提供的回呼。系統會為每個元素呼叫回呼，例如 callback(element, index)。
getArray
getArray()
參數：無
傳回值：  Array<T>
傳回基礎陣列的參考資料。警告：如果陣列已變異，則此物件不會引發任何事件。
getAt
getAt(i)
參數： 
  • i：number
傳回值：  T
傳回指定索引處的元素。
getLength
getLength()
參數：無
傳回值：  number
傳回此陣列的元素數量。
insertAt
insertAt(i, elem)
參數： 
  • i：number
  • elem：T
傳回值：無
在指定的索引處插入元素。
pop
pop()
參數：無
傳回值：  T
移除陣列的最後一個元素，並傳回該元素。
push
push(elem)
參數： 
  • elem：T
傳回值：  number
將一個元素新增至陣列終點，並傳回陣列的新長度。
removeAt
removeAt(i)
參數： 
  • i：number
傳回值：  T
從指定的索引移除元素。
setAt
setAt(i, elem)
參數： 
  • i：number
  • elem：T
傳回值：無
設定指定的索引處之元素。
沿用： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
insert_at
function(index)
引數： 
  • index：number
呼叫 insertAt() 時，會引發此事件。該事件會傳遞已傳遞到 insertAt() 的索引。
remove_at
function(index, removed)
引數： 
  • index：number
  • removed：T 元素已從陣列的 index 移除。
呼叫 removeAt() 時，會引發此事件。該事件會傳遞已傳遞給 removeAt() 的索引，以及從陣列中移除的元素。
set_at
function(index, previous)
引數： 
  • index：number
  • previous：T 先前在陣列中的 index 元素。
呼叫 setAt() 時，會引發此事件。該事件會傳遞之前傳遞至 setAt() 的索引，以及陣列中先前在該索引處的元素。

ErrorEvent 介面

google.maps.ErrorEvent 介面

有相關錯誤的事件。
error
類型：  Error
與事件相關的錯誤。