Info Window

המחלקה InfoWindow

class google.maps.InfoWindow extends MVCObject
library "maps", "streetView"

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

const {InfoWindow} = await google.maps.importLibrary("maps");
 או 
const {InfoWindow} = await google.maps.importLibrary("streetView");
InfoWindow
InfoWindow([opts])
פרמטרים:
יוצר חלון מידע עם האפשרויות שצוינו. אפשר להציב InfoWindow במפה במיקום מסוים או מעל סמן, בהתאם לאפשרויות שצוינו. אם לא משביתים את ההזזה האוטומטית, חלון המידע יזיז את המפה כדי להציג את עצמו כשהוא נפתח. אחרי שיוצרים InfoWindow, צריך להפעיל את open כדי להציג אותו במפה. המשתמש יכול ללחוץ על כפתור הסגירה ב-InfoWindow כדי להסיר אותו מהמפה, או שהמפתח יכול להפעיל את close()‎ כדי להשיג את אותו אפקט.
isOpen
readonly
סוג: boolean
בודק אם InfoWindow פתוח.
close
close()
פרמטרים: אין
הערך המוחזר: אין
סגירת InfoWindow על ידי הסרה שלו ממבנה ה-DOM.
focus
focus()
פרמטרים: אין
הערך המוחזר: אין
המיקוד עובר אל InfoWindow. כדאי לשקול להשתמש בשיטה הזו יחד עם אירוע visible כדי לוודא ש-InfoWindow גלוי לפני שמתמקדים בו. אי אפשר להתמקד ב-InfoWindow שלא גלוי.
getContent
getContent()
פרמטרים: אין
ערך מוחזר: string|Element|Text|null|undefined התוכן של InfoWindow הזה. התוכן זהה למה שהוגדר קודם.
getHeaderContent
getHeaderContent()
פרמטרים: אין
ערך מוחזר: string|Element|Text|null|undefined תוכן הכותרת של InfoWindow הזה. InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
פרמטרים: אין
ערך מוחזר: boolean|undefined אם כל שורת הכותרת מושבתת או לא. InfoWindowOptions.headerDisabled.
getPosition
getPosition()
פרמטרים: אין
ערך החזרה: LatLng|null|undefined המיקום של InfoWindow הזה ב-LatLng.
getZIndex
getZIndex()
פרמטרים: אין
ערך החזרה: number ה-zIndex של InfoWindow הזה.
open
open([options, anchor])
פרמטרים:
  • ‫options: InfoWindowOpenOptions|Map|StreetViewPanorama optional אובייקט InfoWindowOpenOptions (מומלץ) או המפה או התצוגה הפנורמית שבהם יוצג חלון המידע הזה.
  • anchor: MVCObject|AdvancedMarkerElement optional העוגן שבו יוצב ה-InfoWindow הזה. אם העוגן לא ריק, חלון המידע ימוקם במרכז העליון של העוגן. החלון InfoWindow יוצג באותה מפה או תצוגה פנורמית כמו העוגן (אם הוא זמין).
הערך המוחזר: אין
פתיחת InfoWindow במפה הנתונה. אפשר גם לשייך חלון מידע לעוגן. ב-API הראשי, העוגן היחיד הוא המחלקה Marker. עם זאת, עוגן יכול להיות כל MVCObject שחושף מאפיין LatLng position ואופציונלית מאפיין Point anchorPoint לחישוב pixelOffset (ראו InfoWindowOptions). הערך anchorPoint הוא ההיסט ממיקום העוגן לקצה של InfoWindow. מומלץ להשתמש בממשק InfoWindowOpenOptions כארגומנט היחיד של השיטה הזו. כדי למנוע שינוי של המיקוד בדפדפן בזמן הפתיחה, צריך להגדיר את InfoWindowOpenOptions.shouldFocus לערך false.
setContent
setContent([content])
פרמטרים:
  • content: string|Element|Text optional התוכן שיוצג בחלון המידע הזה.
הערך המוחזר: אין
setHeaderContent
setHeaderContent([headerContent])
פרמטרים:
הערך המוחזר: אין
setHeaderDisabled
setHeaderDisabled([headerDisabled])
פרמטרים:
הערך המוחזר: אין
setOptions
setOptions([options])
פרמטרים:
הערך המוחזר: אין
setPosition
setPosition([position])
פרמטרים:
  • position: LatLng|LatLngLiteral optional המיקום של LatLng שבו יוצג חלון המידע הזה.
הערך המוחזר: אין
setZIndex
setZIndex(zIndex)
פרמטרים:
  • ‫zIndex: number ה-z-index של חלון המידע הזה. חלון מידע עם ערך z-index גבוה יותר יוצג לפני כל חלונות המידע האחרים עם ערך z-index נמוך יותר.
הערך המוחזר: אין
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
ארגומנטים: אין
האירוע הזה מופעל בכל פעם שה-InfoWindow נסגר. לדוגמה, זה יכול לקרות כשקוראים ל-method‏ InfoWindow.close, כשלוחצים על מקש Escape כדי לסגור את InfoWindow, כשלוחצים על כפתור הסגירה או כשמעבירים את InfoWindow למפה אחרת.
closeclick
function()
ארגומנטים: אין
האירוע הזה מופעל כשלוחצים על לחצן הסגירה.
content_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשמאפיין התוכן משתנה.
domready
function()
ארגומנטים: אין
האירוע הזה מופעל כשה-<div> שמכיל את התוכן של ה-InfoWindow מצורף ל-DOM. אם אתם יוצרים את התוכן של חלון המידע באופן דינמי, כדאי לעקוב אחרי האירוע הזה.
headercontent_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשהמאפיין headerContent משתנה.
headerdisabled_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשהמאפיין headerDisabled משתנה.
position_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשמאפיין המיקום משתנה.
visible
function()
ארגומנטים: אין
האירוע הזה מופעל כשהמודעה מסוג InfoWindow גלויה במלואה. האירוע הזה לא מופעל כשמזיזים את InfoWindow אל מחוץ למסך ואז בחזרה לתוך המסך.
zindex_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כש-zIndex של InfoWindow משתנה.

הממשק InfoWindowOptions

ממשק google.maps.InfoWindowOptions

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

הממשק InfoWindowOpenOptions

ממשק google.maps.InfoWindowOpenOptions

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