Event system

הכיתה event

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)
פרמטרים: 
  • 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
הרשמה של גורם מטפל באירועים בדפדפנים שונים. כדי להסיר את המאזין הזה, קוראים ל-removeListener(handle) עבור ה-handle שמוחזר על ידי הפונקציה הזו.
addDomListenerOnce
addDomListenerOnce(instance, eventName, handler[, capture])
פרמטרים: 
  • instanceObject
  • eventNamestring
  • handlerFunction
  • captureboolean optional
ערך המוחזר:  MapsEventListener
עטיפה של addDomListener שמסירה את ה-listener אחרי האירוע הראשון.

הממשק MapsEventListener

ממשק google.maps.MapsEventListener

מאזין לאירועים, שנוצר על ידי google.maps.event.addListener() וחברים.

remove
remove()
פרמטרים:  ללא
ערך המוחזר:  void
הסרת המאזין.

קריאה לפונקציה listener.remove() זהה לקריאה לפונקציה google.maps.event.removeListener(listener).

הכיתה MVCObject

google.maps.MVCObject class

מחלקה בסיסית שמטמיעה את KVO.

מובטח שה-constructor של MVCObject יהיה פונקציה ריקה, ולכן אפשר לרשת מ-MVCObject על ידי כתיבת MySubclass.prototype = new google.maps.MVCObject();. אלא אם צוין אחרת, הדבר לא נכון לגבי כיתות אחרות ב-API, ואין תמיכה בירושה מכיתות אחרות ב-API.

אפשר לגשת אליו באמצעות חיוג למספר const {MVCObject} = await google.maps.importLibrary("core"). ספריות ב-Maps JavaScript API

MVCObject
MVCObject()
פרמטרים:  ללא
יצירת MVCObject.
addListener
addListener(eventName, handler)
פרמטרים: 
  • eventNamestring
  • handlerFunction
ערך המוחזר:  MapsEventListener
הפונקציה הזו מוסיפה את פונקציית ה-listener שצוינה לשם האירוע שצוין. הפונקציה מחזירה מזהה של המאזין הזה שאפשר להשתמש בו עם 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> class

הכיתה הזו היא תת-מחלקה של 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
מריצים חזרה על כל רכיב, ומפעילים את פונקציית ה-callback שצוינה. פונקציית ה-callback נקראת לכל רכיב, לדוגמה: callback(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
הגדרת רכיב באינדקס שצוין.
עובר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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
השגיאה שקשורה לאירוע.