Event system

מרחב שמות של אירוע

google.maps.event namespace
library "core"

מרחב שמות לכל הפונקציות של האירועים הציבוריים

const {event} = await google.maps.importLibrary("core");
addListener
addListener(instance, eventName, handler)
פרמטרים:
ערך מוחזר: MapsEventListener
מוסיפה את פונקציית ה-listener הנתונה לשם האירוע הנתון של מופע האובייקט הנתון. מחזירה מזהה למאזין הזה שאפשר להשתמש בו עם removeListener()‎.
addListenerOnce
addListenerOnce(instance, eventName, handler)
פרמטרים:
ערך מוחזר: MapsEventListener
כמו addListener, אבל ה-handler מסיר את עצמו אחרי הטיפול באירוע הראשון.
clearInstanceListeners
clearInstanceListeners(instance)
פרמטרים:
ערך מוחזר: void
מסירה את כל המאזינים לכל האירועים של המופע הנתון.
clearListeners
clearListeners(instance, eventName)
פרמטרים:
  • instance: Object
  • eventName: string
ערך מוחזר: void
מסירה את כל פונקציות ה-listener של האירוע הנתון במופע הנתון.
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)‎ עבור ה-handle שמוחזר על ידי הפונקציה הזו.
addDomListenerOnce
addDomListenerOnce(instance, eventName, handler[, capture])
פרמטרים:
  • instance: Object
  • eventName: ‏string
  • handler: ‏Function
  • capture: boolean optional
ערך מוחזר: MapsEventListener
מעטפת סביב addDomListener שמסירה את פונקציית ה-listener אחרי האירוע הראשון.

ממשק MapsEventListener

ממשק google.maps.MapsEventListener

רכיב event listener, שנוצר על ידי google.maps.event.addListener() וחברים.

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

קריאה ל-listener.remove() שווה ערך ל-google.maps.event.removeListener(listener).

המחלקה MVCObject

google.maps.MVCObject ספריית
הכיתה "core"

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

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

const {MVCObject} = await google.maps.importLibrary("core");
MVCObject
MVCObject()
פרמטרים: אין
יצירת MVCObject.
addListener
addListener(eventName, handler)
פרמטרים:
ערך מוחזר: MapsEventListener
מוסיפה את פונקציית ה-listener הנתונה לשם האירוע הנתון. מחזירה מזהה למאזין הזה שאפשר להשתמש בו עם google.maps.event.removeListener.
bindTo
bindTo(key, target[, targetKey, noNotify])
פרמטרים:
  • key: string
  • target: ‏MVCObject
  • targetKey: ‏string optional
  • noNotify: boolean optional
הערך המוחזר: אין
מקשר בין תצוגה למודל.
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> class
extends MVCObject
library "core"

const {MVCArray} = await google.maps.importLibrary("core");
MVCArray
MVCArray([array])
פרמטרים:
  • array: Array<T> optional
מערך MVC שניתן לשינוי.
clear
clear()
פרמטרים: אין
הערך המוחזר: אין
מסירה את כל הרכיבים מהמערך.
forEach
forEach(callback)
פרמטרים:
  • callback: function(T, number): void
הערך המוחזר: אין
חזרה על כל רכיב, קריאה לקריאה החוזרת (callback) שסופקה. הקריאה החוזרת נקראת לכל רכיב, למשל: 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
השגיאה שקשורה לאירוע.