שיעור InfoWindow
כיתה google.maps.InfoWindow
שכבת-על שנראית כמו בועה, שלרוב מקושרת לסמן.
הכיתה הזו מרחיבה את
MVCObject
.
כדי לקבל גישה, צריך להתקשר ל-const {InfoWindow} = await google.maps.importLibrary("maps")
או ל-const {InfoWindow} = await google.maps.importLibrary("streetView")
. כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
יצרן | |
---|---|
InfoWindow |
InfoWindow([opts]) פרמטרים:
יוצר חלון מידע עם האפשרויות הנתונים. ניתן למקם את InfoWindow במפה במיקום מסוים או מעל לסמן, בהתאם למה שצוין באפשרויות. אלא אם הזזת המפה האוטומטית מושבתת, המידע של מערכת WindowsWind ינוע על המפה כדי להפוך אותה לגלויה כשהיא תיפתח. לאחר בניית מידע, צריך להתקשר ל-OpenWindow כדי להציג אותו במפה. המשתמש יכול ללחוץ על לחצן הסגירה ב-InfoWindow כדי להסיר אותו מהמפה, או שהמפתח יכול לקרוא ל-close() עבור אותה השפעה. |
שיטות | |
---|---|
close |
close() פרמטרים: ללא
ערך החזרה: אין
סוגר את ה-InfoWindow על ידי הסרתו ממבנה ה-DOM. |
focus |
focus() פרמטרים: ללא
ערך החזרה: אין
מגדיר את המיקוד ב InfoWindow הזה. מומלץ להשתמש בשיטה הזו יחד עם אירוע visible כדי לוודא שהשדה InfoWindow גלוי לפני שמגדירים את המיקוד שלו. לא ניתן לטרגט InfoWindow שאינו גלוי. |
getContent |
getContent() פרמטרים: ללא
|
getPosition |
getPosition() פרמטרים: ללא
ערך החזרה:
LatLng|null|undefined מיקום LatLng של InfoWindow זה. |
getZIndex |
getZIndex() פרמטרים: ללא
ערך החזרה:
number האינדקס של zIndexed של InfoWindow זה. |
open |
open([options, anchor]) פרמטרים:
ערך החזרה: אין
פתיחה של infoWindow במפה נתונה. באופן אופציונלי, ניתן לשייך את InfoWindow לעוגן. ב-API המרכזי, העוגן היחיד הוא מחלקת הסמן. עם זאת, עוגן יכול להיות כל MVCObject שחושף נכס LatLng position , ואופציונלית גם נכס של נקודה anchorPoint לחישוב pixelOffset (מידע נוסף ב-InfoWindowOptions). anchorPoint הוא הסטייה ממיקום העוגן לקצה של ה-InfoWindow. מומלץ להשתמש בממשק של InfoWindowOpenOptions כארגומנט יחיד עבור השיטה הזו. כדי למנוע שינוי של מיקוד הדפדפן במצב פתוח, מגדירים את InfoWindowOpenOptions.shouldFocus בתור false . |
setContent |
setContent([content]) ערך החזרה: אין
|
setOptions |
setOptions([options]) פרמטרים:
ערך החזרה: אין
|
setPosition |
setPosition([position]) פרמטרים:
ערך החזרה: אין
|
setZIndex |
setZIndex(zIndex) פרמטרים:
ערך החזרה: אין
|
הועבר בירושה:
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() ארגומנטים: ללא
האירוע הזה מופעל כשמדד האינדקס של InfoWindow משתנה. |
הממשק של InfoWindowOptions
ממשק google.maps.InfoWindowOptions
אובייקט InfoWindowOptions המשמש להגדרת המאפיינים שניתן להגדיר ב-InfoWindow.
מאפיינים | |
---|---|
ariaLabel optional |
סוג:
string optional AriaLabel להקצאה לספק ה-InfoWindow. |
content optional |
תוכן להצגה ב-InfoWindow. הרכיב הזה יכול להיות אלמנט HTML, מחרוזת טקסט פשוט או מחרוזת שמכילה HTML. גודל ה-InfoWindow ישתנה בהתאם לתוכן. כדי להגדיר גודל מפורש לתוכן, מגדירים תוכן כרכיב 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 ההיסט, בפיקסלים, מהטיפ של חלון המידע מהנקודה במפה שבה הקואורדינטות הגיאוגרפיות מעוגנות את חלון המידע. אם OpenWindow נפתח עם עוגן, pixelOffset יחושב מנכס anchorPoint של העוגן. |
position optional |
סוג:
LatLng|LatLngLiteral optional ה-LatLng שבו יש להציג את ה-InfoWindow הזה. אם InfoWindow נפתח עם עוגן, מיקום העוגן ישמש במקום זאת. |
zIndex optional |
סוג:
number optional כל המידע של WindowsWindows מוצג במפה לפי סדר האינדקס שלה, כאשר ערכים גבוהים יותר מוצגים לפני הערך של WindowsWindows עם ערכים נמוכים יותר. כברירת מחדל, המידע של WindowsWindows מוצג בהתאם לקווי הרוחב שלהם, כאשר InfoWindows של קווי רוחב נמוכים יותר מופיע לפני InfoInfo בקווי רוחב גבוהים יותר. המידע של Windows תמיד מוצג לפני הסמנים. |
הממשק של InfoWindowOpenOptions
ממשק google.maps.InfoWindowOpenOptions
אפשרויות לפתיחת InfoWindow
מאפיינים | |
---|---|
anchor optional |
סוג:
MVCObject|AdvancedMarkerElement optional העוגן שאליו מערכת InfoWindow תמוקם. אם העוגן אינו אפס, ה-InfoWindow ימוקם בחלק העליון האמצעי של העוגן. ה-InfoWindow יעובד באותה מפה או פנורמה (כשהאפשרות זמינה). |
map optional |
סוג:
Map|StreetViewPanorama optional המפה או הפנורמה שבה יש לעבד את InfoWindow זה. |
shouldFocus optional |
סוג:
boolean optional האם להעביר את המיקוד בתוך ה-InfoWindow כשהוא נפתח. כשהנכס הזה לא מוגדר או כשהוא מוגדר לערך null או undefined , נעשה שימוש בהיוריסטיקה כדי לקבוע אם להעביר את המיקוד. מומלץ להגדיר את הנכס הזה כך שיתאים בדיוק לצרכים שלכם, כי בשיטה ההוריסטית עשויים להשתנות ויכול להיות שהוא לא יתאים לכל תרחישי השימוש. |