Event system

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

event 命名空間

google.maps.event 命名空間

addListener
addListener(instance, eventName, handler)
參數:
傳回值:MapsEventListener
針對指定的物件實例,將特定的接聽函式新增至特定的事件名稱。傳回可用於 removeListener() 的此接聽程式識別碼。
addListenerOnce
addListenerOnce(instance, eventName, handler)
參數:
傳回值:MapsEventListener
功能和 addListener 相同,但在處理第一個事件後,處理常式會自行移除。
clearInstanceListeners
clearInstanceListeners(instance)
參數:
傳回值:
針對特定實例移除所有事件的所有接聽程式。
clearListeners
clearListeners(instance, eventName)
參數:
  • instanceObject
  • eventNamestring
傳回值:
針對特定實例移除指定事件的所有接聽程式。
hasListeners
hasListeners(instance, eventName)
參數:
  • instanceObject
  • eventNamestring
傳回值:boolean
如果指定的執行個體有事件監聽器,則傳回。用來儲存昂貴事件的詳細資料。
removeListener
removeListener(listener)
參數:
傳回值:
移除指定的事件監聽器,應在上方的 addListener 傳回。等同於呼叫 listener.remove()
trigger
trigger(instance, eventName, eventArgs)
參數:
  • instanceObject
  • eventNamestring
  • eventArgs...*
傳回值:
觸發指定事件。eventName 後面的所有引數會傳送成給接聽程式的引數。
addDomListener
addDomListener(instance, eventName, handler[, capture])
參數:
  • instanceObject
  • eventNamestring
  • handlerFunction
  • captureboolean optional
傳回值:MapsEventListener
註冊跨瀏覽器事件處理常式。呼叫 removeListener(handle) 移除這個接聽程式,即可取得此函式傳回的處理權。
addDomListenerOnce
addDomListenerOnce(instance, eventName, handler[, capture])
參數:
  • instanceObject
  • eventNamestring
  • handlerFunction
  • captureboolean optional
傳回值:MapsEventListener
addDomListener 周圍的包裝函式,會在第一個事件發生後移除接聽程式。

MapsEventListener 介面

google.maps.MapsEventListener 介面介面

google.maps.event.addListener() 和好友建立的事件監聽器。

remove
remove()
參數:
傳回值:
移除監聽器。

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

MVCObject 類別

google.maps.MVCObject 類別

實作 KVO 的基礎類別。

MVCObject 建構函式一定是空白的函式,所以您可以編寫 MySubclass.prototype = new google.maps.MVCObject(); 來沿用 MVCObject 的函式。除非另有註明,否則這個 API 中的其他類別並無上述情況,我們不支援沿用 API 中其他類別。

MVCObject
MVCObject()
參數:
建立 MVCObject
addListener
addListener(eventName, handler)
參數:
傳回值:MapsEventListener
將指定的事件監聽器函式新增至特定事件名稱。傳回可與 google.maps.event.removeListener 搭配使用的此事件監聽器的 ID。
bindTo
bindTo(key, target[, targetKey, noNotify])
參數:
  • keystring
  • targetMVCObject
  • targetKeystring optional
  • noNotifyboolean optional
傳回值:
將 View 連結至 Model。
get
get(key)
參數:
  • keystring
傳回值:?
取得一個值。
notify
notify(key)
參數:
  • keystring
傳回值:
通知所有觀察者這個屬性的變動。這樣會同時通知連結至物件屬性的物件,以及它連結的物件。
set
set(key, value)
參數:
  • keystring
  • value*
傳回值:
設定一個值。
setValues
setValues([values])
參數:
傳回值:
設定「按鍵值」對組的集合。
unbind
unbind(key)
參數:
  • keystring
傳回值:
移除連結。取消連結會將未連結的屬性設為目前值。物件不會收到通知,因為值未變更。
unbindAll
unbindAll()
參數:
傳回值:
移除所有連結。

MVCArray類別

google.maps.MVCArray<T> 類別

這個類別會擴充 MVCObject

MVCArray
MVCArray([array])
參數:
  • arrayArray<T> optional
易變的 MVC 陣列。
clear
clear()
參數:
傳回值:
移除陣列中的所有元素。
forEach
forEach(callback)
參數:
  • callbackfunction(T, number): void
傳回值:
反覆執行每個元素,呼叫提供的回呼。系統會為每個元素呼叫回呼,例如 callback(element, index)。
getArray
getArray()
參數:
傳回值:Array<T>
傳回基礎陣列的參考資料。警告:如果陣列已變異,則此物件不會引發任何事件。
getAt
getAt(i)
參數:
  • inumber
傳回值:T
傳回指定索引處的元素。
getLength
getLength()
參數:
傳回值:number
傳回此陣列的元素數量。
insertAt
insertAt(i, elem)
參數:
  • inumber
  • elemT
傳回值:
在指定的索引處插入元素。
pop
pop()
參數:
傳回值:T
移除陣列的最後一個元素,並傳回該元素。
push
push(elem)
參數:
  • elemT
傳回值:number
將一個元素新增至陣列終點,並傳回陣列的新長度。
removeAt
removeAt(i)
參數:
  • inumber
傳回值:T
從指定的索引移除元素。
setAt
setAt(i, elem)
參數:
  • inumber
  • elemT
傳回值:
設定指定的索引處之元素。
已沿用: addListenerbindTogetnotifysetsetValuesunbindunbindAll
insert_at
function(index)
引數:
  • indexnumber
系統會在呼叫 insertAt() 時觸發這個事件。事件會傳遞傳送至 insertAt() 的索引。
remove_at
function(index, removed)
引數:
  • indexnumber
  • removedT元素已從 index 的陣列中移除。
系統會在呼叫 removeAt() 時觸發這個事件。事件會傳遞傳送至 removeAt() 的索引,以及從陣列中移除的元素。
set_at
function(index, previous)
引數:
  • indexnumber
  • previousT先前在 index 陣列中的元素。
系統會在呼叫 setAt() 時觸發這個事件。事件會傳遞傳遞至 setAt() 的索引,以及先前在該索引中的陣列元素。

ErrorEvent 介面

google.maps.ErrorEvent 介面介面

含有相關錯誤的事件。

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