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]) פרמטרים:  opts:  InfoWindowOptions optional יוצר חלון מידע עם האפשרויות הנתונים. ניתן למקם 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]) פרמטרים:  headerContent:  string|Element|Text optional תוכן הכותרת שיוצג על ידי InfoWindow הזה. פרטים נוספים זמינים בInfoWindowOptions.headerContent. ערך החזרה: ללא
setHeaderDisabled	setHeaderDisabled([headerDisabled]) פרמטרים:  headerDisabled:  boolean optional מציין אם להשבית את כל שורת הכותרת. פרטים נוספים זמינים בInfoWindowOptions.headerDisabled. ערך החזרה: ללא
setOptions	setOptions([options]) פרמטרים:  options:  InfoWindowOptions optional ערך החזרה: ללא
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, נעשה שימוש בשיטה היוריסטית כדי לקבוע אם להעביר את המיקוד. מומלץ להגדיר את המאפיין הזה באופן מפורש כך שיתאים לצרכים שלך, כי היוריסטיקה עשויה להשתנות ויכול להיות שהיא לא תפעל כמו שצריך בכל התרחישים לדוגמה.