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 כדי להסיר אותו מהמפה, או שהמפתח יכול לקרוא ל-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]) פרמטרים:  options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional אובייקט InfoWindowOpenOptions (מומלץ) או המפה|פנורמה שבה יש לעבד את InfoWindow הזה. anchor:  MVCObject|AdvancedMarkerElement optional העוגן שאליו ימוקם חלון המידע הזה. אם העוגן לא null, חלון ה-InfoWindow ימוקם במרכז החלק העליון של העוגן. עיבוד המידע של InfoWindow יוצג באותה מפה או באותה פנורמה כמו העוגן (אם זמין). ערך החזרה: ללא פתיחת InfoWindow זו במפה הנתונה. באופן אופציונלי, ניתן לשייך חלון מידע לעוגן. ב-API הליבה, העוגן היחיד הוא מחלקת הסמן. עם זאת, עוגן יכול להיות כל MVCObject שחושף מאפיין LatLng position, ובאופן אופציונלי גם מאפיין נקודה anchorPoint לחישוב ה-pixelOffset (פרטים נוספים זמינים ב-InfoWindowOptions). הערך anchorPoint מייצג את ההפרש בין מיקום העוגן לבין קצה ה-InfoWindow. מומלץ להשתמש בממשק InfoWindowOpenOptions כארגומנט היחיד לשיטה זו. כדי למנוע שינוי של המיקוד של הדפדפן לפתיחה, צריך להגדיר את InfoWindowOpenOptions.shouldFocus לערך false.
setContent	setContent([content]) פרמטרים:  content:  string|Element|Text optional התוכן שיוצג על ידי InfoWindow הזה. ערך החזרה: ללא
setOptions	setOptions([options]) פרמטרים:  options:  InfoWindowOptions optional ערך החזרה: ללא
setPosition	setPosition([position]) פרמטרים:  position:  LatLng|LatLngLiteral optional המיקום של LatLng שבו יש להציג את חלון המידע הזה. ערך החזרה: ללא
setZIndex	setZIndex(zIndex) פרמטרים:  zIndex:  number מדד ה-z של InfoWindow הזה. InfoWindow עם אינדקס z גדול יותר יוצג לפני כל שאר InfoWindows עם אינדקס z נמוך יותר. ערך החזרה: ללא
עברה בירושה: 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. כדאי לעקוב אחרי האירוע הזה אם אתם בונים את התוכן של חלון המידע באופן דינמי.
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, נעשה שימוש בשיטה היוריסטית כדי להחליט אם להעביר את המיקוד או לא. מומלץ להגדיר את המאפיין הזה באופן מפורש בהתאם לצרכים שלכם, מכיוון שהשיטה היוריסטית עשויה להשתנות ויכול להיות שלא תפעל היטב בכל תרחישי השימוש.