Event system

event class

google.maps.event class

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

撥打 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 class

google.maps.MVCObject class

實作 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
將指定監聽器函式新增至指定事件名稱。傳回這個接聽程式的 ID，可用於 google.maps.event.removeListener。
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 class

google.maps.MVCArray<T> class

這個類別會擴充 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
與事件相關的錯誤。