הודעת אבטחה: נודע לנו על בעיית אבטחה שעשויה להשפיע על אתרים שמשתמשים בספריות ספציפיות של צד שלישי (כולל polyfill.io). בעיה זו עלולה לפעמים להפנות מבקרים אל מחוץ לאתר המיועד ללא ידיעתו או אישור של בעלי האתר. רבות מדוגמאות ה-JavaScript שלנו כללו בעבר הצהרה של סקריפט polyfill.io. הסרנו את הדוגמאות האלה מהדוגמאות. אם השתמשת בדוגמאות JavaScript שלנו שמכילות את ההצהרה הזו, מומלץ להסיר את ההצהרה.

דף זה תורגם על ידי Cloud Translation API.

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() כדי לקבל את אותה האפקט.

יצרן

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`

אירועים
`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`, נעשה שימוש בשיטה היוריסטית כדי להחליט אם להעביר את המיקוד או לא. מומלץ להגדיר את המאפיין הזה באופן מפורש בהתאם לצרכים שלכם, מכיוון שהשיטה היוריסטית עשויה להשתנות ויכול להיות שלא תפעל היטב בכל תרחישי השימוש.

Info Window

המחלקה InfoWindow

יצרן

שיטות

אירועים

ממשק InfoWindowOptions

תכונות

ממשק InfoWindowOpenOptions

תכונות