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, עליך לקרוא ל-Open כדי להציג אותו במפה. המשתמש יכול ללחוץ על לחצן הסגירה ב-InfoWindow כדי להסיר אותו מהמפה, או המפתח יכול לקרוא ל-open() כדי להשיג את אותו ההשפעה.
isOpen
סוג:  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 המיקום LatLng של InfoWindow הזה.
getZIndex
getZIndex()
פרמטרים: ללא
ערך החזרה:  number ה-zIndex של חלון InfoWindow הזה.
open
open([options, anchor])
פרמטרים: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional אובייקט InfoWindowOpenOptions (מומלץ) או המפה|פנורמה שבה יש לעבד את InfoWindow הזה.
  • anchor:  MVCObject|AdvancedMarkerElement optional העוגן שאליו ימוקם InfoWindow הזה. אם העוגן אינו null, ה-InfoWindow ימוקם במרכז העליון של העוגן. InfoWindow תעובד באותה מפה או באותה פנורמה כמו העוגן (אם זמין).
ערך החזרה: ללא
פתיחת חלון המידע הזה במפה הנתונה. לחלופין, ניתן לשייך InfoWindow לעוגן. ב- Core API, העוגן היחיד הוא המחלקה של 'עט סימון'. עם זאת, עוגן יכול להיות כל MVCObject שחושף מאפיין LatLng position ואופציונלית מאפיין Point anchorPoint לחישוב pixelOffset (ראו InfoWindowOptions). anchorPoint מייצג את הסטייה ממיקום העוגן עד לקצה של InfoWindow. מומלץ להשתמש בממשק InfoWindowOpenOptions כארגומנט יחיד לשיטה הזו. כדי למנוע שינוי של מיקוד הדפדפן בפתיחה, צריך להגדיר את InfoWindowOpenOptions.shouldFocus לערך false.
setContent
setContent([content])
פרמטרים: 
  • content:  string|Element|Text optional התוכן שיוצג על ידי InfoWindow הזה.
ערך החזרה: ללא
setHeaderContent
setHeaderContent([headerContent])
פרמטרים: 
ערך החזרה: ללא
setHeaderDisabled
setHeaderDisabled([headerDisabled])
פרמטרים: 
  • headerDisabled:  boolean optional מציין אם להשבית את כל שורת הכותרת. פרטים נוספים זמינים בInfoWindowOptions.headerDisabled.
ערך החזרה: ללא
setOptions
setOptions([options])
פרמטרים: 
ערך החזרה: ללא
setPosition
setPosition([position])
פרמטרים: 
  • position:  LatLng|LatLngLiteral optional מיקום ה-LatLng שבו יוצג חלון המידע הזה.
ערך החזרה: ללא
setZIndex
setZIndex(zIndex)
פרמטרים: 
  • zIndex:  number ה-z-index של InfoWindow הזה. InfoWindow עם z-index גדול יותר תוצג לפני כל יתר InfoWindows עם אינדקס z נמוך יותר.
ערך החזרה: ללא
בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
ארגומנטים: ללא
האירוע הזה מופעל בכל פעם ש-InfoWindow נסגר. לדוגמה, הפעולה יכולה להיות קריאה לשיטה 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 optional
סוג:  string optional
AriaLabel שצריך להקצות ל-InfoWindow.
content optional
סוג:  string|Element|Text optional
תוכן שיוצג ב-InfoWindow. זה יכול להיות רכיב HTML, מחרוזת של טקסט פשוט או מחרוזת שמכילה HTML. הגודל של InfoWindow ישתנה בהתאם לתוכן. כדי להגדיר גודל מפורש לתוכן, צריך להגדיר את התוכן כרכיב HTML בגודל הזה.
disableAutoPan optional
סוג:  boolean optional
ברירת המחדל: false
השבת הזזה של המפה כדי שה-InfoWindow יהיה גלוי במלואו כשהוא נפתח.
headerContent optional
סוג:  string|Element|Text optional
התוכן שיוצג בשורת הכותרת InfoWindow. זה יכול להיות רכיב HTML או מחרוזת של טקסט פשוט. הגודל של InfoWindow ישתנה בהתאם לתוכן. כדי להגדיר גודל מפורש לתוכן הכותרת, צריך להגדיר את headerContent כרכיב HTML בגודל הזה.
headerDisabled optional
סוג:  boolean optional
משביתה את כל שורת הכותרת ב-InfoWindow. אם המדיניות מוגדרת כ-True, הכותרת תוסר, כך שתוכן הכותרת ולחצן הסגירה יוסתרו.
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 שבו יש להציג את InfoWindow הזה. אם InfoWindow נפתחה באמצעות עוגן, ייעשה שימוש במיקום של העוגן.
zIndex optional
סוג:  number optional
כל InfoWindows מוצגים במפה לפי סדר ה-zIndex שלהם, כאשר ערכים גבוהים יותר מוצגים לפני 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, נעשה שימוש בשיטה היוריסטית כדי לקבוע אם להעביר את המיקוד. מומלץ להגדיר את המאפיין הזה באופן מפורש כך שיתאים לצרכים שלך, כי היוריסטיקה עשויה להשתנות ויכול להיות שהיא לא תפעל כמו שצריך בכל התרחישים לדוגמה.