Info Window

‫InfoWindow class

google.maps.InfoWindow class

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

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

כדי לגשת, מתקשרים למספר const {InfoWindow} = await google.maps.importLibrary("maps") או const {InfoWindow} = await google.maps.importLibrary("streetView").
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

יצרן

InfoWindow

InfoWindow([opts]) פרמטרים:  opts:  InfoWindowOptions optional יוצר חלון מידע עם האפשרויות שצוינו. אפשר למקם חלון מידע במפה במיקום מסוים או מעל סמן, בהתאם למה שמצוין באפשרויות. אלא אם משביתים את ההזזה האוטומטית, חלון המידע יזיז את המפה כדי שיוצג כשהוא נפתח. אחרי שיוצרים חלון מידע, צריך לקרוא לפונקציה open כדי להציג אותו במפה. המשתמש יכול ללחוץ על לחצן הסגירה בחלון המידע כדי להסיר אותו מהמפה, או שהמפתח יכול לקרוא לפונקציה close() כדי להשיג את אותה התוצאה.

מאפיינים
isOpen	סוג:  boolean בודקת אם חלון המידע פתוח.

Methods
close	close() פרמטרים:  אין ערך מוחזר:  אין הפונקציה סוגרת את חלון המידע הזה על ידי הסרתו ממבנה ה-DOM.
focus	focus() פרמטרים:  אין ערך מוחזר:  אין הפוקוס מוגדר על InfoWindow. כדאי להשתמש בשיטה הזו יחד עם אירוע visible כדי לוודא שרכיב InfoWindow גלוי לפני שמגדירים את המיקוד עליו. אי אפשר להתמקד בInfoWindow שלא גלוי.
getContent	getContent() פרמטרים:  אין ערך החזרה:  string|Element|Text|null|undefined התוכן של חלון המידע הזה. זהה למה שהוגדר קודם כתוכן.
getHeaderContent	getHeaderContent() פרמטרים:  אין ערך ההחזרה:  string|Element|Text|null|undefined תוכן הכותרת של חלון המידע הזה. מידע נוסף מפורט בInfoWindowOptions.headerContent.
getHeaderDisabled	getHeaderDisabled() פרמטרים:  אין ערך ההחזרה:  boolean|undefined האם שורת הכותרת כולה מושבתת או לא. מידע נוסף מפורט בInfoWindowOptions.headerDisabled.
getPosition	getPosition() פרמטרים:  אין ערך ההחזרה:  LatLng|null|undefined מיקום LatLng של חלון המידע הזה.
getZIndex	getZIndex() פרמטרים:  אין ערך החזרה:  number הערך של zIndex של חלון המידע הזה.
open	open([options, anchor]) פרמטרים:  ‫options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional אובייקט InfoWindowOpenOptions (מומלץ) או map|panorama שבו יבוצע העיבוד של חלון המידע הזה. ‫anchor:  MVCObject|AdvancedMarkerElement optional נקודת העיגון שחלון המידע הזה ימוקם ביחס אליה. אם העוגן הוא לא null, חלון המידע ימוקם במרכז העליון של העוגן. חלון המידע יוצג באותה מפה או תצוגת פנורמה כמו נקודת העוגן (אם יש). ערך מוחזר:  אין פותח את חלון המידע הזה במפה הנתונה. אפשר גם לשייך חלון מידע לעוגן. ב-API הליבה, העוגן היחיד הוא המחלקה Marker. עם זאת, עוגן יכול להיות כל MVCObject שחושף מאפיין LatLng position ואופציונלית מאפיין Point anchorPoint לחישוב pixelOffset (ראו InfoWindowOptions). ‫anchorPoint הוא ההיסט ממיקום העוגן לקצה של חלון המידע. מומלץ להשתמש בממשק InfoWindowOpenOptions כארגומנט יחיד לשיטה הזו. כדי למנוע שינוי של המיקוד בדפדפן בזמן הפתיחה, מגדירים את InfoWindowOpenOptions.shouldFocus ל-false.
setContent	setContent([content]) פרמטרים:  ‫content:  string|Element|Text optional התוכן שיוצג בחלון המידע הזה. ערך מוחזר:  אין
setHeaderContent	setHeaderContent([headerContent]) פרמטרים:  ‫headerContent:  string|Element|Text optional תוכן הכותרת שיוצג בחלון המידע הזה. מידע נוסף מפורט ב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 של חלון המידע הזה. חלון מידע עם ערך z-index גבוה יותר יוצג לפני כל חלונות המידע האחרים עם ערך z-index נמוך יותר. ערך מוחזר:  אין
בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

אירועים
close	function() ארגומנטים:  אין האירוע הזה מופעל בכל פעם שחלון InfoWindow נסגר. לדוגמה, יכול להיות שהמשתמש יסגור את חלון המידע על ידי קריאה לשיטה InfoWindow.close, לחיצה על מקש Escape, לחיצה על לחצן הסגירה או העברה של חלון המידע למפה אחרת.
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 interface

google.maps.InfoWindowOptions ממשק

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

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

‫InfoWindowOpenOptions interface

google.maps.InfoWindowOpenOptions ממשק

אפשרויות לפתיחת חלון מידע

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