Info Window

המחלקה InfoWindow

google.maps.InfoWindow סיווג

שכבת-על שנראית כמו בועה ובדרך כלל מחוברת לסמן.

הכיתה הזו משתרעת על פני MVCObject.

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

InfoWindow
InfoWindow([opts])
פרמטרים: 
יצירת חלון מידע עם האפשרויות הנתונות. ניתן למקם חלון מידע במפה במיקום מסוים או מעל סמן, בהתאם לאפשרויות שצוינו. אם הסיבוב האוטומטי לא מושבת, InfoWindow יזיז את המפה כדי להפוך אותו לגלוי כשהוא נפתח. לאחר בניית InfoWindow, עליך לפתוח כדי להציג אותו על המפה. המשתמש יכול ללחוץ על לחצן הסגירה ב-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 zIndex של InfoWindow הזה.
open
open([options, anchor])
פרמטרים: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional אובייקט InfoWindowOpenOptions (מומלץ) או המפה|פנורמה שבה יש לעבד את InfoWindow הזה.
  • anchorMVCObject|AdvancedMarkerElement optional העוגן שאליו ימוקם חלון המידע הזה. אם העוגן לא null, חלון ה-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 שבו יש להציג את חלון המידע הזה.
ערך החזרה: ללא
setZIndex
setZIndex(zIndex)
פרמטרים: 
  • zIndexnumber מדד ה-z של InfoWindow הזה. InfoWindow עם אינדקס 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()
ארגומנטים: ללא
האירוע הזה מופעל כשה-zIndex של InfoWindow משתנה.

ממשק InfoWindowOptions

ממשק google.maps.InfoWindowOptions

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

ariaLabel optional
סוג:  string optional
AriaLabel להקצאה ל-InfoWindow.
content optional
סוג:  string|Element|Text optional
תוכן להצגה ב-InfoWindow. זה יכול להיות רכיב HTML, מחרוזת של טקסט פשוט או מחרוזת שמכילה HTML. גודל חלון המידע ישתנה בהתאם לתוכן. כדי להגדיר גודל מפורש של התוכן, צריך להגדיר את התוכן כרכיב 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
הקיזוז, בפיקסלים, של קצה חלון המידע מהנקודה במפה שבקואורדינטות הגיאוגרפיות שלה מעוגן חלון המידע. אם InfoWindow נפתח עם עוגן, ה-pixelOffset יחושב מהמאפיין anchorPoint של העוגן.
position optional
סוג:  LatLng|LatLngLiteral optional
סמל ה-LatLng שבו יש להציג את חלון המידע הזה. אם חלון המידע נפתח באמצעות עוגן, ייעשה שימוש במיקום העוגן במקום זאת.
zIndex optional
סוג:  number optional
כל InfoWindows מוצגים במפה לפי סדר ה-zIndex שלהם, כאשר ערכים גבוהים יותר מוצגים לפני InfoWindows עם ערכים נמוכים יותר. כברירת מחדל, InfoWindows מוצגים בהתאם לקווי הרוחב שלהם, כאשר InfoWindows בקווי רוחב נמוכים יותר מופיעים לפני InfoWindows בקווי רוחב גבוהים יותר. InfoWindows מוצגים תמיד לפני הסמנים.

ממשק InfoWindowOpenOptions

ממשק google.maps.InfoWindowOpenOptions

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

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