Info Window

کلاس InfoWindow

google.maps.InfoWindow class
extends MVCObject
library "maps", "streetView"

یک هم‌پوشانی که شبیه حباب است و اغلب به یک نشانگر متصل است.

const {InfoWindow} = await google.maps.importLibrary("maps");

یا

const {InfoWindow} = await google.maps.importLibrary("streetView");

سازنده

InfoWindow

InfoWindow([opts]) پارامترها: ‫opts:‏ InfoWindowOptions optional پنجره اطلاعاتی با گزینه‌های ارائه‌شده ایجاد می‌کند. InfoWindow را می‌توان در موقعیت خاصی روی نقشه یا بالای نشانگر قرار داد، بسته به آنچه در گزینه‌ها مشخص شده است. مگر اینکه حرکت خودکار غیرفعال باشد، InfoWindow نقشه را حرکت می‌دهد تا هنگام باز شدن قابل مشاهده باشد. پس‌از ساختن InfoWindow، باید open را فراخوانی کنید تا در نقشه نمایش داده شود. کاربر می‌تواند روی دکمه بستن در InfoWindow کلیک کند تا آن را از نقشه بردارد، یا توسعه‌دهنده می‌تواند close()‎ را برای همان جلوه فراخوانی کند.

مشخصات
isOpen readonly	نوع: 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 می‌تواند با لنگری مرتبط شود. در میانای برنامه‌سازی کاربردی اصلی، تنها لنگر کلاس Marker است. بااین‌حال، لنگر می‌تواند هر MVCObject باشد که ویژگی LatLng position و به‌طور اختیاری ویژگی Point anchorPoint را برای محاسبه pixelOffset نشان می‌دهد (به InfoWindowOptions مراجعه کنید). anchorPoint فاصله از موقعیت لنگر تا نوک InfoWindow است. توصیه می‌شود از میانای InfoWindowOpenOptions به‌عنوان تنها شناسه برای این روش استفاده کنید. برای جلوگیری از تغییر تمرکز مرورگر هنگام باز شدن، InfoWindowOpenOptions.shouldFocus را روی false تنظیم کنید.
setContent	setContent([content]) پارامترها: ‫content: string|Element|Text optional محتوایی که باید توسط این InfoWindow نمایش داده شود. مقدار برگشتی: هیچ
setHeaderContent	setHeaderContent([headerContent]) پارامترها: headerContent: string|Element|Text optional محتوای سرصفحه که توسط این InfoWindow نمایش داده می‌شود. InfoWindowOptions.headerContent را ببینید. مقدار برگشتی: هیچ
setHeaderDisabled	setHeaderDisabled([headerDisabled]) پارامترها: ‫headerDisabled:‏ boolean optional مشخص می‌کند که آیا کل ردیف سرصفحه غیرفعال شود یا نه. InfoWindowOptions.headerDisabled را ببینید. مقدار برگشتی: هیچ
setOptions	setOptions([options]) پارامترها: ‫options:‏ InfoWindowOptions optional مقدار برگشتی: هیچ
setPosition	setPosition([position]) پارامترها: position: LatLng|LatLngLiteral optional موقعیت طول و عرض جغرافیایی که این InfoWindow در آن نمایش داده می‌شود. مقدار برگشتی: هیچ
setZIndex	setZIndex(zIndex) پارامترها: zIndex: number z-index برای این InfoWindow. InfoWindow با شاخص z بزرگ‌تر در جلوی همه InfoWindowهای دیگر با شاخص z کوچک‌تر نمایش داده می‌شود. مقدار برگشتی: هیچ
به‌ارث‌رسیده: 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

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

مشخصات
ariaLabel اختیاری	نوع: string optional AriaLabel برای اختصاص دادن به InfoWindow.
content اختیاری	نوع: string|Element|Text optional محتوایی که در InfoWindow نمایش داده می‌شود. این می‌تواند یک عنصر HTML، یک رشته نوشتار ساده، یا یک رشته حاوی HTML باشد. اندازه InfoWindow براساس محتوا تعیین می‌شود. برای تنظیم اندازه صریح برای محتوا، محتوا را طوری تنظیم کنید که عنصر HTML با آن اندازه باشد.
disableAutoPan اختیاری	نوع: boolean optional پیش‌فرض: false غیرفعال کردن حرکت افقی نقشه برای نمایان کردن کامل InfoWindow هنگام باز شدن آن.
headerContent اختیاری	نوع: string|Element|Text optional محتوایی که در ردیف سرصفحه InfoWindow نمایش داده می‌شود. این می‌تواند یک عنصر HTML یا رشته‌ای از نوشتار ساده باشد. اندازه InfoWindow براساس محتوا تعیین می‌شود. برای تنظیم اندازه صریح برای محتوای سرایند، headerContent را به‌عنوان عنصر HTML با آن اندازه تنظیم کنید.
headerDisabled اختیاری	نوع: boolean optional کل ردیف سرصفحه را در InfoWindow غیرفعال می‌کند. وقتی روی «درست» تنظیم شود، سرصفحه برداشته می‌شود تا محتوای سرصفحه و دکمه بستن پنهان شود.
maxWidth اختیاری	نوع: number optional حداکثر عرض InfoWindow، صرف‌نظر از عرض محتوا. این مقدار فقط درصورتی درنظر گرفته می‌شود که قبل‌از تماس با open() تنظیم شده باشد. برای تغییر دادن حداکثر عرض هنگام تغییر محتوا، close()، setOptions()، و سپس open() را فراخوانی کنید.
minWidth اختیاری	نوع: number optional حداقل عرض InfoWindow، صرف‌نظر از عرض محتوا. هنگام استفاده از این ویژگی، اکیداً توصیه می‌شود minWidth را روی مقداری کمتر از عرض نقشه (به پیکسل) تنظیم کنید. این مقدار فقط درصورتی درنظر گرفته می‌شود که قبل‌از تماس با open() تنظیم شده باشد. برای تغییر دادن حداقل عرض هنگام تغییر محتوا، close()، setOptions()، و سپس open() را فراخوانی کنید.
pixelOffset اختیاری	نوع: Size optional انحراف، برحسب پیکسل، نوک پنجره اطلاعات از نقطه‌ای روی نقشه که پنجره اطلاعات در مختصات جغرافیایی آن لنگر انداخته است. اگر InfoWindow با لنگر باز شود، pixelOffset از ویژگی anchorPoint لنگر محاسبه خواهد شد.
position اختیاری	نوع: LatLng|LatLngLiteral optional طول و عرض جغرافیایی که این InfoWindow در آن نمایش داده می‌شود. اگر InfoWindow با لنگر باز شود، به‌جای آن از موقعیت لنگر استفاده خواهد شد.
zIndex اختیاری	نوع: number optional همه InfoWindows به‌ترتیب zIndex خود روی نقشه نمایش داده می‌شوند، به‌طوری‌که مقادیر بالاتر در جلوی InfoWindows با مقادیر پایین‌تر نمایش داده می‌شوند. به‌طور پیش‌فرض، InfoWindows براساس عرض جغرافیایی‌شان نمایش داده می‌شوند، به‌طوری‌که InfoWindows با عرض جغرافیایی پایین‌تر در جلوی InfoWindows با عرض جغرافیایی بالاتر ظاهر می‌شوند. InfoWindows همیشه در جلوی نشانگرها نمایش داده می‌شود.

میانای InfoWindowOpenOptions

میانا google.maps.InfoWindowOpenOptions

گزینه‌های باز کردن InfoWindow

مشخصات
anchor اختیاری	نوع: MVCObject|AdvancedMarkerElement optional لنگری که این InfoWindow در آن قرار خواهد گرفت. اگر لنگر غیرتهی باشد، InfoWindow در مرکز بالای لنگر قرار می‌گیرد. ‫InfoWindow در همان نقشه یا تمام‌نمایی که لنگر (درصورت وجود) قرار دارد ارائه خواهد شد.
map اختیاری	نوع: Map|StreetViewPanorama optional نقشه یا تمام‌نمایی که این InfoWindow در آن ارائه می‌شود.
shouldFocus اختیاری	نوع: boolean optional اینکه وقتی InfoWindow باز می‌شود، تمرکز باید به داخل آن منتقل شود یا نه. وقتی این ویژگی تنظیم نشده باشد یا وقتی روی null یا undefined تنظیم شده باشد، از یک روش اکتشافی برای تصمیم‌گیری درباره اینکه آیا تمرکز باید منتقل شود یا نه استفاده می‌شود. توصیه می‌شود این ویژگی را به‌طور صریح تنظیم کنید تا با نیازهایتان مطابقت داشته باشد، زیرا روش اکتشافی ممکن است تغییر کند و برای همه موارد استفاده به‌خوبی کار نکند.