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]) مولفه های: opts : InfoWindowOptions optional یک پنجره اطلاعات با گزینه های داده شده ایجاد می کند. یک InfoWindow را می توان بر روی نقشه در یک موقعیت خاص یا بالای یک نشانگر قرار داد، بسته به آنچه در گزینه ها مشخص شده است. مگر اینکه حرکت خودکار غیرفعال باشد، یک InfoWindow نقشه را می‌چرخاند تا هنگام باز شدن آن، خود را قابل مشاهده کند. پس از ساخت InfoWindow، باید open را فراخوانی کنید تا روی نقشه نمایش داده شود. کاربر می‌تواند روی دکمه بستن در 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 لنگری که این 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 نمایش داده شود. ارزش بازگشتی: ندارد
setOptions	setOptions([options]) مولفه های: options : InfoWindowOptions optional ارزش بازگشتی: ندارد
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 متصل شود. اگر محتوای پنجره اطلاعات خود را به صورت پویا ایجاد می کنید، ممکن است بخواهید این رویداد را نظارت کنید.
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 کاملاً قابل مشاهده باشد.
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 تنظیم می شود، از یک اکتشافی برای تصمیم گیری در مورد تغییر یا عدم تغییر فوکوس استفاده می شود. توصیه می‌شود به صراحت این ویژگی را مطابق با نیازهای خود تنظیم کنید، زیرا اکتشافی در معرض تغییر است و ممکن است برای همه موارد استفاده خوب کار نکند.