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)
参数
  • instanceObject
  • eventNamestring
返回值void
对于指定实例,删除其指定事件的所有侦听器。
hasListeners
hasListeners(instance, eventName)
参数
  • instanceObject
  • eventNamestring
返回值boolean
如果指定实例上的指定事件有监听器,则返回 。可用于节省成本高昂的事件详情的计算。
removeListener
removeListener(listener)
参数
返回值void
删除本应由上述 addListener 返回的指定监听器。相当于调用 listener.remove()
trigger
trigger(instance, eventName, eventArgs)
参数
  • instanceObject
  • eventNamestring
  • eventArgs...?
返回值void
触发指定事件。eventName 后的所有参数都以参数的形式传递到侦听器。
addDomListener
addDomListener(instance, eventName, handler[, capture])
参数
  • instanceObject
  • eventNamestring
  • handlerFunction
  • captureboolean optional
返回值MapsEventListener
跨浏览器事件处理程序注册。可以通过调用该函数所返回句柄的 eventRemoveListener(handle) 来删除此监听器。
addDomListenerOnce
addDomListenerOnce(instance, eventName, handler[, capture])
参数
  • instanceObject
  • eventNamestring
  • handlerFunction
  • captureboolean 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 配合使用。
bindTo
bindTo(key, target[, targetKey, noNotify])
参数
  • keystring
  • targetMVCObject
  • targetKeystring optional
  • noNotifyboolean optional
返回值:None
将视图绑定到模型。
get
get(key)
参数
  • keystring
返回值?
获取值。
notify
notify(key)
参数
  • keystring
返回值:None
通知所有观察者此属性有所改变。这会通知绑定到对象属性的对象以及绑定到的对象。
set
set(key, value)
参数
  • keystring
  • value*
返回值:None
设置值。
setValues
setValues([values])
参数
返回值:None
设置键值对集合。
unbind
unbind(key)
参数
  • keystring
返回值:None
删除绑定。取消绑定会将未绑定属性设置为当前值。将不会通知该对象,因为值尚未更改。
unbindAll
unbindAll()
参数:无
返回值:None
删除所有绑定。

MVCArray

google.maps.MVCArray<T>

此类扩展了 MVCObject

通过调用 const {MVCArray} = await google.maps.importLibrary("core") 进行访问。请参阅 Maps JavaScript API 中的库

MVCArray
MVCArray([array])
参数
  • arrayArray<T> optional
一个易变的 MVC 数组。
clear
clear()
参数:无
返回值:None
从数组中删除所有元素。
forEach
forEach(callback)
参数
  • callbackfunction(T, number): void
返回值:None
循环访问每个元素,调用所提供的回调。为每个元素调用回调,如:回调 (element, index)。
getArray
getArray()
参数:无
返回值Array<T>
返回对底层数组的参考。警告:如果数组发生变化,则该对象不会触发任何事件。
getAt
getAt(i)
参数
  • inumber
返回值T
返回指定索引处的元素。
getLength
getLength()
参数:无
返回值number
传回此数组中的元素数。
insertAt
insertAt(i, elem)
参数
  • inumber
  • elemT
返回值:None
在指定索引处插入元素。
pop
pop()
参数:无
返回值T
删除数组的最后一个元素并传回该元素。
push
push(elem)
参数
  • elemT
返回值number
将一个元素添加到数组末尾并传回数组的新长度。
removeAt
removeAt(i)
参数
  • inumber
返回值T
从指定索引处删除元素。
setAt
setAt(i, elem)
参数
  • inumber
  • elemT
返回值:None
在指定索引处设置元素。
继承的样式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
与事件相关的错误。