Info Window

הכיתה InfoWindow

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

אירועים
close	function() ארגומנטים:  None האירוע הזה מופעל בכל פעם ש-InfoWindow נסגר. לדוגמה, יכול להיות שהאירוע הזה יתרחש כתוצאה מהפעלת השיטה InfoWindow.close, מהקשה על מקש Escape כדי לסגור את חלון המידע, או מהקלקה על לחצן הסגירה או מהזזת חלון המידע למפה אחרת.
closeclick	function() ארגומנטים:  None האירוע הזה מופעל כשלוחצים על לחצן הסגירה.
content_changed	function() ארגומנטים:  None האירוע הזה מופעל כשנכס התוכן משתנה.
domready	function() ארגומנטים:  None האירוע הזה מופעל כשה-<div> שמכיל את התוכן של ה-InfoWindow מצורף ל-DOM. כדאי לעקוב אחרי האירוע הזה אם אתם יוצרים את התוכן של חלון המידע באופן דינמי.
headercontent_changed	function() ארגומנטים:  None האירוע הזה מופעל כשיש שינוי במאפיין headerContent.
headerdisabled_changed	function() ארגומנטים:  None האירוע הזה מופעל כשהנכס headerDisabled משתנה.
position_changed	function() ארגומנטים:  None האירוע הזה מופעל כשיש שינוי במאפיין המיקום.
visible	function() ארגומנטים:  None האירוע הזה מופעל כשה-InfoWindow גלוי במלואו. האירוע הזה לא מופעל כשInfoWindow מופנה החוצה ואז חזרה למסך.
zindex_changed	function() ארגומנטים:  None האירוע הזה מופעל כשה-zIndex של InfoWindow משתנה.

הממשק InfoWindowOptions

ממשק google.maps.InfoWindowOptions

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

מאפיינים
ariaLabel optional	סוג:  string optional תווית ARIA להקצאה לחלון המידע.
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 ההיסט, בפיקסלים, של קצה חלון המידע מהנקודה במפה שבקואורדינטות הגיאוגרפיות שלה חלון המידע מקובע. אם חלון מידע נפתח באמצעות עוגן, הערך של pixelOffset מחושב מהנכס anchorPoint של העוגן.
position optional	סוג:  LatLng|LatLngLiteral optional קו הרוחב והאורך שבהם יוצג חלון המידע. אם חלון המידע נפתח באמצעות עוגן, המערכת תשתמש במיקום של העוגן במקום זאת.
zIndex optional	סוג:  number optional כל חלונות המידע מוצגים במפה לפי הערך שלהם ב-zIndex, כאשר ערכים גבוהים יותר מוצגים לפני חלונות מידע עם ערכים נמוכים יותר. כברירת מחדל, חלונות המידע מוצגים לפי קו הרוחב שלהם, כאשר חלונות מידע של קוי רוחב נמוכים יותר מופיעים לפני חלונות מידע של קוי רוחב גבוהים יותר. חלונות המידע תמיד מוצגים לפני הסמנים.

הממשק InfoWindowOpenOptions

ממשק google.maps.InfoWindowOpenOptions

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

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