Info Window

کلاس InfoWindow

google.maps . 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])
مولفه های:
یک پنجره اطلاعات با گزینه های داده شده ایجاد می کند. یک InfoWindow را می توان بر روی نقشه در یک موقعیت خاص یا بالای یک نشانگر قرار داد، بسته به آنچه در گزینه ها مشخص شده است. مگر اینکه حرکت خودکار غیرفعال باشد، یک InfoWindow نقشه را می‌چرخاند تا هنگام باز شدن آن، خود را قابل مشاهده کند. پس از ساخت InfoWindow، باید open را فراخوانی کنید تا روی نقشه نمایش داده شود. کاربر می‌تواند روی دکمه بستن در InfoWindow کلیک کند تا آن را از نقشه حذف کند، یا توسعه‌دهنده می‌تواند برای همین افکت، close() را فراخوانی کند.
isOpen
نوع: boolean
باز بودن InfoWindow را بررسی می کند.
close
close()
پارامترها: ندارد
ارزش بازگشتی: ندارد
این InfoWindow را با حذف آن از ساختار DOM می‌بندد.
focus
focus()
پارامترها: ندارد
ارزش بازگشتی: ندارد
فوکوس را روی این InfoWindow تنظیم می کند. ممکن است بخواهید از این روش به همراه یک رویداد visible استفاده کنید تا مطمئن شوید که InfoWindow قبل از تنظیم فوکوس روی آن قابل مشاهده است. یک InfoWindow که قابل مشاهده نیست نمی تواند فوکوس شود.
getContent
getContent()
پارامترها: ندارد
مقدار بازگشتی: string| Element | Text |null|undefined محتوای این InfoWindow. همان چیزی که قبلاً به عنوان محتوا تنظیم شده بود.
getHeaderContent
getHeaderContent()
پارامترها: ندارد
مقدار بازگشتی: string| Element | Text |null|undefined محتوای سرصفحه این InfoWindow. InfoWindowOptions.headerContent را ببینید.
getHeaderDisabled
getHeaderDisabled()
پارامترها: ندارد
مقدار برگشتی: boolean|undefined اینکه آیا کل ردیف سرصفحه غیرفعال است یا خیر. InfoWindowOptions.headerDisabled را ببینید.
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 لنگری که این InfoWindow روی آن قرار خواهد گرفت. اگر لنگر غیر تهی باشد، InfoWindow در مرکز بالای لنگر قرار می گیرد. InfoWindow روی همان نقشه یا پانورامای لنگر (در صورت موجود بودن) ارائه می‌شود.
ارزش بازگشتی: ندارد
این InfoWindow را روی نقشه داده شده باز می کند. به صورت اختیاری، InfoWindow را می توان با یک لنگر مرتبط کرد. در هسته API، تنها لنگر کلاس Marker است. با این حال، یک لنگر می تواند هر MVCObjectی باشد که یک ویژگی position LatLng و به صورت اختیاری یک ویژگی Point anchorPoint برای محاسبه pixelOffset را نشان می دهد (به InfoWindowOptions مراجعه کنید). anchorPoint فاصله بین موقعیت لنگر تا نوک InfoWindow است. توصیه می شود از رابط InfoWindowOpenOptions به عنوان آرگومان واحد برای این روش استفاده کنید. برای جلوگیری از تغییر فوکوس مرورگر در حالت باز، InfoWindowOpenOptions.shouldFocus را روی false تنظیم کنید.
setContent
setContent([content])
مولفه های:
  • content : string| Element | Text optional محتوایی که باید توسط این InfoWindow نمایش داده شود.
ارزش بازگشتی: ندارد
setHeaderContent
setHeaderContent([headerContent])
مولفه های:
ارزش بازگشتی: ندارد
setHeaderDisabled
setHeaderDisabled([headerDisabled])
مولفه های:
  • headerDisabled : boolean optional مشخص می کند که آیا کل ردیف سرصفحه غیرفعال شود یا خیر. InfoWindowOptions.headerDisabled را ببینید.
ارزش بازگشتی: ندارد
setOptions
setOptions([options])
مولفه های:
ارزش بازگشتی: ندارد
setPosition
setPosition([position])
مولفه های:
  • position : LatLng | LatLngLiteral optional موقعیت LatLng که در آن این InfoWindow نمایش داده می شود.
ارزش بازگشتی: ندارد
setZIndex
setZIndex(zIndex)
مولفه های:
  • zIndex : number Z-index برای این InfoWindow. یک InfoWindow با z-index بیشتر در مقابل تمام InfoWindow های دیگر با z-index کمتر نمایش داده می شود.
ارزش بازگشتی: ندارد
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll
close
function()
استدلال ها: هیچ
این رویداد هر زمان که InfoWindow بسته شود فعال می شود. به عنوان مثال، این می تواند از فراخوانی روش InfoWindow.close ، فشار دادن کلید escape برای بستن InfoWindow، یا کلیک کردن روی دکمه بستن یا انتقال InfoWindow به نقشه دیگری باشد.
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

google.maps . InfoWindowOptions رابط google.maps . InfoWindowOptions

آبجکت InfoWindowOptions برای تعریف ویژگی هایی که می توانند در InfoWindow تنظیم شوند استفاده می شود.

ariaLabel optional
نوع: string optional
AriaLabel برای اختصاص دادن به InfoWindow.
content optional
نوع: string| Element | Text optional
محتوا برای نمایش در InfoWindow. این می تواند یک عنصر HTML، یک رشته متن ساده یا یک رشته حاوی HTML باشد. InfoWindow با توجه به محتوا اندازه می شود. برای تنظیم یک اندازه صریح برای محتوا، محتوا را به عنوان یک عنصر HTML با آن اندازه تنظیم کنید.
disableAutoPan optional
نوع: boolean optional
پیش فرض: false
جابجایی نقشه را غیرفعال کنید تا هنگام باز شدن InfoWindow کاملاً قابل مشاهده باشد.
headerContent optional
نوع: string| Element | Text optional
محتوایی که باید در ردیف سرصفحه InfoWindow نمایش داده شود. این می تواند یک عنصر HTML یا رشته ای از متن ساده باشد. InfoWindow با توجه به محتوا اندازه می شود. برای تنظیم یک اندازه صریح برای محتوای هدر، headerContent را به عنوان یک عنصر HTML با آن اندازه تنظیم کنید.
headerDisabled optional
نوع: boolean optional
کل ردیف سرصفحه را در InfoWindow غیرفعال می کند. وقتی روی true تنظیم شود، هدر حذف می شود تا محتوای سرصفحه و دکمه بستن پنهان شود.
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 که در آن این InfoWindow نمایش داده می شود. اگر InfoWindow با یک لنگر باز شود، به جای آن از موقعیت لنگر استفاده می شود.
zIndex optional
نوع: number optional
همه InfoWindows به ترتیب zIndex خود بر روی نقشه نمایش داده می شوند و مقادیر بالاتر در مقابل InfoWindows با مقادیر کمتر نمایش داده می شوند. به طور پیش فرض، InfoWindows با توجه به عرض جغرافیایی خود نمایش داده می شود، با InfoWindows از عرض های جغرافیایی پایین تر در مقابل InfoWindows در عرض های جغرافیایی بالاتر ظاهر می شود. InfoWindows همیشه جلوی نشانگرها نمایش داده می شود.

رابط InfoWindowOpenOptions

google.maps . 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 تنظیم می شود، از یک اکتشافی برای تصمیم گیری در مورد تغییر یا عدم تغییر فوکوس استفاده می شود. توصیه می‌شود به صراحت این ویژگی را مطابق با نیازهای خود تنظیم کنید، زیرا اکتشافی در معرض تغییر است و ممکن است برای همه موارد استفاده خوب کار نکند.