Info Window

שיעור InfoWindow

כיתה google.maps.InfoWindow

שכבת-על שנראית כמו בועה, שלרוב מקושרת לסמן.

הכיתה הזו מרחיבה את MVCObject.

כדי לקבל גישה, צריך להתקשר ל-const {InfoWindow} = await google.maps.importLibrary("maps") או ל-const {InfoWindow} = await google.maps.importLibrary("streetView"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.

InfoWindow
InfoWindow([opts])
פרמטרים: 
יוצר חלון מידע עם האפשרויות הנתונים. ניתן למקם את InfoWindow במפה במיקום מסוים או מעל לסמן, בהתאם למה שצוין באפשרויות. אלא אם הזזת המפה האוטומטית מושבתת, המידע של מערכת WindowsWind ינוע על המפה כדי להפוך אותה לגלויה כשהיא תיפתח. לאחר בניית מידע, צריך להתקשר ל-OpenWindow כדי להציג אותו במפה. המשתמש יכול ללחוץ על לחצן הסגירה ב-InfoWindow כדי להסיר אותו מהמפה, או שהמפתח יכול לקרוא ל-close() עבור אותה השפעה.
close
close()
פרמטרים: ללא
ערך החזרה: אין
סוגר את ה-InfoWindow על ידי הסרתו ממבנה ה-DOM.
focus
focus()
פרמטרים: ללא
ערך החזרה: אין
מגדיר את המיקוד בInfoWindow הזה. מומלץ להשתמש בשיטה הזו יחד עם אירוע visible כדי לוודא שהשדה InfoWindow גלוי לפני שמגדירים את המיקוד שלו. לא ניתן לטרגט InfoWindow שאינו גלוי.
getContent
getContent()
פרמטרים: ללא
ערך החזרה:  string|Element|Text|null|undefined התוכן של ה-InfoWindow הזה. זהה להגדרה שהייתה בעבר.
getPosition
getPosition()
פרמטרים: ללא
ערך החזרה:  LatLng|null|undefined מיקום LatLng של InfoWindow זה.
getZIndex
getZIndex()
פרמטרים: ללא
ערך החזרה:  numberהאינדקס של zIndexed של InfoWindow זה.
open
open([options, anchor])
פרמטרים: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional אובייקט (InfoWindowOpenOptions) (מומלץ) או המפה|פנורמה שבה יש לעבד את ה-InfoWindow הזה.
  • anchorMVCObject|AdvancedMarkerElement optional העוגן שאליו מערכת WindowsWindow תמוקם. אם העוגן אינו אפס, ה-InfoWindow ימוקם בחלק העליון האמצעי של העוגן. ה-InfoWindow יעובד באותה מפה או פנורמה (כשהאפשרות זמינה).
ערך החזרה: אין
פתיחה של infoWindow במפה נתונה. באופן אופציונלי, ניתן לשייך את InfoWindow לעוגן. ב-API המרכזי, העוגן היחיד הוא מחלקת הסמן. עם זאת, עוגן יכול להיות כל MVCObject שחושף נכס LatLng position, ואופציונלית גם נכס של נקודה anchorPoint לחישוב pixelOffset (מידע נוסף ב-InfoWindowOptions). anchorPoint הוא הסטייה ממיקום העוגן לקצה של ה-InfoWindow. מומלץ להשתמש בממשק של InfoWindowOpenOptions כארגומנט יחיד עבור השיטה הזו. כדי למנוע שינוי של מיקוד הדפדפן במצב פתוח, מגדירים את InfoWindowOpenOptions.shouldFocus בתור false.
setContent
setContent([content])
פרמטרים: 
  • contentstring|Element|Text optional התוכן שיוצג ב-InfoWindow.
ערך החזרה: אין
setOptions
setOptions([options])
פרמטרים: 
ערך החזרה: אין
setPosition
setPosition([position])
פרמטרים: 
  • positionLatLng|LatLngLiteral optional מיקום ה-LatLng שבו יש להציג את פרטי WindowsWindow.
ערך החזרה: אין
setZIndex
setZIndex(zIndex)
פרמטרים: 
  • zIndexnumber אינדקס ה-z של ה-InfoWindow הזה. השדה WindowsWindow עם אינדקס z גדול יותר יוצג מול כל שאר ה-InfoWindows עם אינדקס z נמוך יותר.
ערך החזרה: אין
הועבר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
ארגומנטים: ללא
האירוע הזה מופעל כשלוחצים על לחצן הסגירה.
content_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס התוכן משתנה.
domready
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר השדה <div> שמכיל את התוכן של InfoWindow מצורף ל-DOM. מומלץ לעקוב אחר אירוע זה אם אתם בונים את התוכן של חלון המידע באופן דינמי.
position_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס המיקום משתנה.
visible
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר ניתן לראות את InfoWindow באופן מלא. האירוע הזה לא מופעל אם InfoWindow מושבת או מושבת ואז חוזר למסך.
zindex_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשמדד האינדקס של InfoWindow משתנה.

הממשק של InfoWindowOptions

ממשק google.maps.InfoWindowOptions

אובייקט InfoWindowOptions המשמש להגדרת המאפיינים שניתן להגדיר ב-InfoWindow.

ariaLabel optional
סוג:  string optional
AriaLabel להקצאה לספק ה-InfoWindow.
content optional
סוג:  string|Element|Text optional
תוכן להצגה ב-InfoWindow. הרכיב הזה יכול להיות אלמנט HTML, מחרוזת טקסט פשוט או מחרוזת שמכילה HTML. גודל ה-InfoWindow ישתנה בהתאם לתוכן. כדי להגדיר גודל מפורש לתוכן, מגדירים תוכן כרכיב HTML בגודל הזה.
disableAutoPan optional
סוג:  boolean optional
ברירת מחדל: false
השבתת הזזה של המפה כדי ש-InfoWindow יהיה גלוי במלואו כשהוא ייפתח.
maxWidth optional
סוג:  number optional
הרוחב המקסימלי של ה-InfoWindow, בלי קשר לרוחב התוכן. הערך הזה נלקח בחשבון רק אם הוא הוגדר לפני הקריאה ל-open(). כדי לשנות את הרוחב המרבי בעת שינוי תוכן, יש להתקשר אל close(), setOptions() ולאחר מכן אל open().
minWidth optional
סוג:  number optional
הרוחב המינימלי של InfoWindow, ללא קשר לרוחב התוכן. כשמשתמשים במאפיין הזה, מומלץ מאוד להגדיר את minWidth לערך שקטן מרוחב המפה (בפיקסלים). הערך הזה נלקח בחשבון רק אם הוא הוגדר לפני הקריאה ל-open(). כדי לשנות את הרוחב המינימלי במהלך שינוי תוכן, יש להתקשר אל close(), setOptions() ולאחר מכן אל open().
pixelOffset optional
סוג:  Size optional
ההיסט, בפיקסלים, מהטיפ של חלון המידע מהנקודה במפה שבה הקואורדינטות הגיאוגרפיות מעוגנות את חלון המידע. אם OpenWindow נפתח עם עוגן, pixelOffset יחושב מנכס anchorPoint של העוגן.
position optional
סוג:  LatLng|LatLngLiteral optional
ה-LatLng שבו יש להציג את ה-InfoWindow הזה. אם InfoWindow נפתח עם עוגן, מיקום העוגן ישמש במקום זאת.
zIndex optional
סוג:  number optional
כל המידע של WindowsWindows מוצג במפה לפי סדר האינדקס שלה, כאשר ערכים גבוהים יותר מוצגים לפני הערך של WindowsWindows עם ערכים נמוכים יותר. כברירת מחדל, המידע של WindowsWindows מוצג בהתאם לקווי הרוחב שלהם, כאשר InfoWindows של קווי רוחב נמוכים יותר מופיע לפני InfoInfo בקווי רוחב גבוהים יותר. המידע של Windows תמיד מוצג לפני הסמנים.

הממשק של InfoWindowOpenOptions

ממשק google.maps.InfoWindowOpenOptions

אפשרויות לפתיחת InfoWindow

anchor optional
סוג:  MVCObject|AdvancedMarkerElement optional
העוגן שאליו מערכת InfoWindow תמוקם. אם העוגן אינו אפס, ה-InfoWindow ימוקם בחלק העליון האמצעי של העוגן. ה-InfoWindow יעובד באותה מפה או פנורמה (כשהאפשרות זמינה).
map optional
סוג:  Map|StreetViewPanorama optional
המפה או הפנורמה שבה יש לעבד את InfoWindow זה.
shouldFocus optional
סוג:  boolean optional
האם להעביר את המיקוד בתוך ה-InfoWindow כשהוא נפתח. כשהנכס הזה לא מוגדר או כשהוא מוגדר לערך null או undefined, נעשה שימוש בהיוריסטיקה כדי לקבוע אם להעביר את המיקוד. מומלץ להגדיר את הנכס הזה כך שיתאים בדיוק לצרכים שלכם, כי בשיטה ההוריסטית עשויים להשתנות ויכול להיות שהוא לא יתאים לכל תרחישי השימוש.