نمای کلی کنترلها
نقشههای نمایشدادهشده ازطریق Maps JavaScript API حاوی عناصر میانای کاربر هستند تا تعامل کاربر با نقشه را امکانپذیر کنند. این عناصر بهعنوان کنترلها شناخته میشوند و میتوانید انواع مختلفی از این کنترلها را در برنامهتان بگنجانید. یا میتوانید کاری نکنید و اجازه دهید Maps JavaScript API همه رفتارهای کنترل را مدیریت کند.
نقشه زیر مجموعه پیشفرض کنترلهای نمایشدادهشده توسط Maps JavaScript API را نشان میدهد:
در جهت عقربههای ساعت از بالا سمت راست: نوع نقشه، تمامصفحه، دوربین، نمای خیابان، میانبرهای صفحهکلید.
در زیر، فهرست مجموعه کامل کنترلهایی که میتوانید در نقشههایتان استفاده کنید آمده است:
- کنترل نوع نقشه در یک منو کرکرهای یا نوار دکمه افقی دردسترس است و به کاربر اجازه میدهد نوع نقشه را انتخاب کند (
ROADMAP،SATELLITE،HYBRID، یاTERRAIN). این کنترل بهطور پیشفرض در گوشه بالا سمت چپ نقشه ظاهر میشود. - کنترل تمامصفحه گزینه باز کردن نقشه در حالت تمامصفحه را ارائه میدهد. این کنترل بهطور پیشفرض در رایانه و دستگاههای همراه فعال است. توجه: iOS از ویژگی تمامصفحه پشتیبانی نمیکند. بنابراین، کنترل تمامصفحه در دستگاههای iOS قابلمشاهده نیست.
- کنترل دوربین هم کنترل بزرگنمایی و هم کنترل حرکت افقی را دارد.
- کنترل نمای خیابان حاوی نماد آدمک است که میتوان آن را روی نقشه کشید تا نمای خیابان فعال شود. این کنترل بهطور پیشفرض نزدیک پایین سمت چپ نقشه نشان داده میشود.
- کنترل چرخش ترکیبی از گزینههای کج کردن و چرخاندن را برای نقشههای حاوی تصاویر سهبعدی ارائه میدهد. این کنترل بهطور پیشفرض نزدیک پایین سمت چپ نقشه نشان داده میشود. برای اطلاعات بیشتر، نمای کلی سهبعدی را ببینید.
- کنترل مقیاس عنصر مقیاس نقشه را نمایش میدهد. این کنترل بهطور پیشفرض غیرفعال است.
- کنترل میانبرهای صفحهکلید فهرستی از میانبرهای صفحهکلید را برای تعامل با نقشه نمایش میدهد.
شما مستقیماً به این کنترلهای نقشه دسترسی ندارید یا آنها را اصلاح نمیکنید. درعوض،
فیلدهای MapOptions نقشه را اصلاح میکنید
که بر نمایان بودن و ارائه کنترلها تأثیر میگذارد. میتوانید ارائه کنترل را هنگام نمونهسازی نقشهتان (با MapOptions مناسب) تنظیم کنید یا با فراخوانی setOptions() برای تغییر گزینههای نقشه، نقشه را بهصورت پویا اصلاح کنید.
همه این کنترلها بهطور پیشفرض فعال نیستند. برای آشنایی با رفتار پیشفرض میانای کاربر (و نحوه اصلاح این رفتار)، به بخش میانای کاربر پیشفرض در زیر مراجعه کنید.
میانای کاربر پیشفرض
بهطور پیشفرض، اگر نقشه خیلی کوچک باشد (۲۰۰×۲۰۰ پیکسل)، همه کنترلها ناپدید میشوند. میتوانید با تنظیم صریح کنترل برای نمایان بودن، این رفتار را لغو کنید. افزودن کنترلها به نقشه را ببینید.
رفتار و ظاهر کنترلها در دستگاههای همراه و رایانه یکسان است، بهجز کنترل تمامصفحه (رفتار شرحدادهشده در فهرست کنترلها را ببینید).
علاوهبراین، مدیریت صفحهکلید بهطور پیشفرض در همه دستگاهها روشن است.
غیرفعال کردن واسط کاربر پیشفرض
شاید بخواهید دکمههای میانای کاربر پیشفرض API را کاملاً خاموش کنید. برای انجام این کار،
خصوصیت disableDefaultUI نقشه را (در
شیء MapOptions) روی true تنظیم کنید. این ویژگی
همه دکمههای کنترل میانای کاربر را از Maps JavaScript API غیرفعال میکند. اما بر اشارههای موشواره یا میانبرهای صفحهکلید در نقشه مبنا تأثیری ندارد، که بهترتیب توسط ویژگیهای gestureHandling و keyboardShortcuts کنترل میشوند.
کد زیر دکمههای میانای کاربر را غیرفعال میکند:
TypeScript
innerMap.setOptions({ // Disable the default UI. disableDefaultUI: true, });
JavaScript
innerMap.setOptions({ // Disable the default UI. disableDefaultUI: true, });
امتحان کردن نمونه
افزودن کنترلها به نقشه
ممکن است بخواهید میانای خود را با برداشتن، افزودن، یا اصلاح کردن رفتار یا کنترلهای میانای کاربر سفارشی کنید و مطمئن شوید که بهروزرسانیهای آینده این رفتار را تغییر نمیدهند. اگر میخواهید فقط رفتار موجود را اضافه یا اصلاح کنید، باید مطمئن شوید که کنترل بهطور صریح به برنامهتان اضافه شده است.
برخیاز کنترلها بهطور پیشفرض در نقشه نشان داده میشوند، درحالیکه برخی دیگر نشان داده نمیشوند
مگر اینکه بهطور خاص آنها را درخواست کنید. افزودن یا برداشتن کنترلها از نقشه در فیلدهای شیء MapOptions زیر مشخص شده است که برای نمایان کردن آنها را روی true تنظیم میکنید یا برای پنهان کردن آنها را روی false تنظیم میکنید:
{ cameraControl: boolean, mapTypeControl: boolean, scaleControl: boolean, streetViewControl: boolean, rotateControl: boolean, fullscreenControl: boolean }
بهطور پیشفرض، اگر نقشه کوچکتر از ۲۰۰×۲۰۰ پیکسل باشد، همه کنترلها ناپدید میشوند.
میتوانید با تنظیم صریح کنترل برای نمایان بودن، این رفتار را لغو کنید. برای مثال، جدول زیر نشان میدهد که آیا کنترل دوربین براساس اندازه نقشه و تنظیم فیلد cameraControl نمایان است یا نه:
| اندازه نقشه | cameraControl |
نمایان است؟ |
|---|---|---|
| همه | false |
نه |
| همه | true |
بله |
| >= ۲۰۰×۲۰۰ پیکسل | undefined |
بله |
| < ۲۰۰×۲۰۰ پیکسل | undefined |
نه |
مثال زیر نقشه را طوری تنظیم میکند که کنترل «دوربین» را پنهان کند و کنترل «مقیاس» را نمایش دهد. توجه داشته باشید که ما میانای کاربر پیشفرض را بهطور صریح غیرفعال نمیکنیم، بنابراین این تغییرات به رفتار میانای کاربر پیشفرض اضافه میشوند.
TypeScript
innerMap.setOptions({ cameraControl: false, scaleControl: true, });
JavaScript
innerMap.setOptions({ cameraControl: false, scaleControl: true, });
امتحان کردن نمونه
گزینههای کنترل
چندین کنترل قابلپیکربندی هستند و به شما امکان میدهند رفتار آنها را تغییر دهید یا ظاهرشان را عوض کنید. برای مثال، کنترل نوع نقشه ممکن است بهصورت نوار افقی یا منوِ کرکرهای نشان داده شود.
این کنترلها با تغییر دادن فیلدهای گزینههای کنترل مناسب در شیء MapOptions هنگام ایجاد نقشه اصلاح میشوند.
برای مثال، گزینههای تغییر کنترل «نوع نقشه» در فیلد mapTypeControlOptions نشان داده شده است. کنترل «نوع نقشه» ممکن است در یکی از گزینههای style زیر نشان داده شود:
google.maps.MapTypeControlStyle.HORIZONTAL_BARآرایه کنترلها را بهصورت دکمه در نوار افقی نمایش میدهد، همانطور که در Google Maps نشان داده شده است.google.maps.MapTypeControlStyle.DROPDOWN_MENUیک کنترل تکدکمهای را نمایش میدهد که به شما امکان میدهد نوع نقشه را بااستفاده از منوِ کرکرهای انتخاب کنید.google.maps.MapTypeControlStyle.DEFAULTرفتار پیشفرض را نمایش میدهد که به اندازه صفحهنمایش بستگی دارد و ممکن است در نسخههای آینده میانای برنامهسازی کاربردی تغییر کند.
توجه داشته باشید که اگر گزینههای کنترل را تغییر دهید، باید با تنظیم مقدار مناسب MapOptions روی true، کنترل را بهطور صریح فعال کنید. برای مثال، برای تنظیم کنترل «نوع نقشه»
برای نمایش سبک DROPDOWN_MENU، از کد زیر در
شیء MapOptions استفاده کنید:
... mapTypeControl: true, mapTypeControlOptions: { style: google.maps.MapTypeControlStyle.DROPDOWN_MENU } ...
مثال زیر نشان میدهد که چگونه میتوان موقعیت و سبک پیشفرض کنترلها را تغییر داد.
TypeScript
innerMap.setOptions({ mapTypeControl: true, mapTypeControlOptions: { style: MapTypeControlStyle.DROPDOWN_MENU, mapTypeIds: [MapTypeId.ROADMAP, MapTypeId.TERRAIN], position: ControlPosition.TOP_CENTER, }, });
JavaScript
innerMap.setOptions({ mapTypeControl: true, mapTypeControlOptions: { style: MapTypeControlStyle.DROPDOWN_MENU, mapTypeIds: [MapTypeId.ROADMAP, MapTypeId.TERRAIN], position: ControlPosition.TOP_CENTER, }, });
امتحان کردن نمونه
کنترلها معمولاً هنگام ایجاد نقشه پیکربندی میشوند. بااینحال،
میتوانید با فراخوانی روش setOptions() مربوط به Map و ارسال گزینههای کنترل جدید به آن،
نحوه نمایش کنترلها را بهصورت پویا تغییر دهید.
اصلاح کنترلها
هنگام ایجاد نقشه، ارائه کنترل را ازطریق فیلدهای موجود در شیء MapOptions نقشه مشخص میکنید. این
فیلدها در زیر نشان داده شدهاند:
cameraControlکنترل دوربین را فعال/ غیرفعال میکند که به کاربر اجازه میدهد نقشه را بزرگنمایی و حرکت دهد. این کنترل بهطور پیشفرض در همه نقشهها قابلمشاهده است. فیلدcameraControlOptionsعلاوهبراینCameraControlOptionsرا برای استفاده در این کنترل مشخص میکند.mapTypeControlکنترل «نوع نقشه» را فعال/ غیرفعال میکند که به کاربر اجازه میدهد بین انواع نقشه (مانند «نقشه» و «ماهواره») جابهجا شود. بهطور پیشفرض، این کنترل قابلمشاهده است و در گوشه بالا سمت چپ نقشه نشان داده میشود. فیلدmapTypeControlOptionsعلاوهبراینMapTypeControlOptionsرا برای استفاده در این کنترل مشخص میکند.streetViewControlکنترل «آدمک» را فعال/ غیرفعال میکند که به کاربر اجازه میدهد تمامنمای «نمای خیابان» را فعال کند. بهطور پیشفرض، این کنترل نمایان است و نزدیک پایین سمت چپ نقشه نشان داده میشود. فیلدstreetViewControlOptionsعلاوهبراینStreetViewControlOptionsرا برای استفاده در این کنترل مشخص میکند.rotateControlظاهر کنترل «چرخش» را برای کنترل جهت تصاویر سهبعدی فعال/ غیرفعال میکند. بهطور پیشفرض، وجود کنترل با وجود یا عدم وجود تصاویر سهبعدی برای نوع نقشه دادهشده در بزرگنمایی و مکان فعلی تعیین میشود. میتوانید با تنظیم کردنrotateControlOptionsنقشه برای مشخص کردنRotateControlOptionsموردنظر برای استفاده، رفتار کنترل را تغییر دهید. این کنترل فقط در نقشههای مبنای سهبعدی نشان داده میشود.scaleControlکنترل «مقیاس» را که مقیاس نقشه را ارائه میدهد فعال/ غیرفعال میکند. بهطور پیشفرض، این کنترل قابلمشاهده نیست. وقتی فعال باشد، همیشه در گوشه پایین سمت چپ نقشه نشان داده میشود. scaleControlOptionsعلاوهبراین،ScaleControlOptionsرا برای استفاده در این کنترل مشخص میکند.fullscreenControlکنترل باز کردن نقشه در حالت تمامصفحه را فعال/ غیرفعال میکند. بهطور پیشفرض، این کنترل در رایانه و دستگاههای Android فعال است. وقتی فعال باشد، این کنترل در نزدیکی بالا سمت چپ نقشه نشان داده میشود. fullscreenControlOptionsعلاوهبراین،FullscreenControlOptionsرا برای استفاده در این کنترل مشخص میکند.
توجه داشته باشید که میتوانید گزینههایی را برای کنترلهایی که در ابتدا غیرفعال میکنید مشخص کنید.
موقعیت کنترل
بیشتر گزینههای کنترل حاوی ویژگی position
(از نوع ControlPosition) هستند که نشان میدهد کنترل در کجای نقشه
قرار گیرد. موقعیت این کنترلها مطلق نیست. درعوض،
میانای برنامهسازی کاربردی کنترلها را بهطور هوشمندانه با جاری کردن آنها در اطراف
عناصر نقشه موجود، یا کنترلهای دیگر، در محدودیتهای دادهشده (مانند
اندازه نقشه) چیدمان میکند.
دو نوع موقعیت کنترل وجود دارد: قدیمی و منطقی. توصیه میشود از مقادیر منطقی استفاده کنید تا بتوانید بهطور خودکار از هر دو بافت چیدمان چپ به راست (LTR) و راست به چپ (RTL) پشتیبانی کنید. راهنمای مرجع را ببینید.
جدولهای زیر موقعیتهای کنترل پشتیبانیشده را در زمینههای چپبهراست و راستبهچپ نشان میدهند.
جایگاههای LTR
| موقعیت | ثابت منطقی (توصیهشده) | ثابت قدیمی |
|---|---|---|
| بالا سمت راست | BLOCK_START_INLINE_START |
TOP_LEFT |
| مرکز بالا | BLOCK_START_INLINE_CENTER |
TOP_CENTER |
| بالا سمت راست | BLOCK_START_INLINE_END |
TOP_RIGHT |
| بالا سمت چپ | INLINE_START_BLOCK_START |
LEFT_TOP |
| چپ مرکز | INLINE_START_BLOCK_CENTER |
LEFT_CENTER |
| پایین سمت چپ | INLINE_START_BLOCK_END |
LEFT_BOTTOM |
| بالا سمت راست | INLINE_END_BLOCK_START |
RIGHT_TOP |
| راست مرکز | INLINE_END_BLOCK_CENTER |
RIGHT_CENTER |
| پایین سمت راست | INLINE_END_BLOCK_END |
RIGHT_BOTTOM |
| پایین سمت چپ | BLOCK_END_INLINE_START |
BOTTOM_LEFT |
| پایین وسط | BLOCK_END_INLINE_CENTER |
BOTTOM_CENTER |
| پایین سمت راست | BLOCK_END_INLINE_END |
BOTTOM_RIGHT |
جایگاههای راست به چپ
| موقعیت | ثابت منطقی (توصیهشده) | ثابت قدیمی |
|---|---|---|
| بالا سمت راست | BLOCK_START_INLINE_START |
TOP_RIGHT |
| مرکز بالا | BLOCK_START_INLINE_CENTER |
TOP_CENTER |
| بالا سمت راست | BLOCK_START_INLINE_END |
TOP_LEFT |
| بالا سمت راست | INLINE_START_BLOCK_START |
RIGHT_TOP |
| راست مرکز | INLINE_START_BLOCK_CENTER |
RIGHT_CENTER |
| پایین سمت راست | INLINE_START_BLOCK_END |
RIGHT_BOTTOM |
| بالا سمت چپ | INLINE_END_BLOCK_START |
LEFT_TOP |
| چپ مرکز | INLINE_END_BLOCK_CENTER |
LEFT_CENTER |
| پایین سمت چپ | INLINE_END_BLOCK_END |
LEFT_BOTTOM |
| پایین سمت راست | BLOCK_END_INLINE_START |
BOTTOM_RIGHT |
| پایین وسط | BLOCK_END_INLINE_CENTER |
BOTTOM_CENTER |
| پایین سمت چپ | BLOCK_END_INLINE_END |
BOTTOM_LEFT |
برای جابهجایی نقشه بین حالتهای چپبهراست و راستبهچپ، روی برچسبها کلیک کنید.
توجه داشته باشید که این موقعیتها ممکن است با موقعیتهای عناصر میانای کاربر که نمیتوانید جای آنها را تغییر دهید (مانند حق نشر و نشانواره Google) تداخل داشته باشند. در این موارد، کنترلها طبق منطق ذکرشده برای هر جایگاه جریان مییابند و تا حد امکان نزدیک به جایگاه نشاندادهشده خود ظاهر میشوند. با توجه به پیچیدگی چیدمانها، هیچ تضمینی وجود ندارد که کنترلها همپوشانی نداشته باشند، هرچند میانای برنامهسازی کاربردی تلاش میکند آنها را بهطور هوشمندانه مرتب کند.
مثال زیر نقشه پایهای را نشان میدهد که همه کنترلها در آن فعال است و در موقعیتهای مختلف قرار دارد.
TypeScript
const mapElement = document.querySelector('gmp-map')!; let innerMap: google.maps.Map; async function init() { // Request needed libraries. const [{ MapTypeControlStyle }, { ControlPosition }] = await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('core'), ]); // Get the inner map. innerMap = mapElement.innerMap; // Set the map's controls options. innerMap.setOptions({ mapTypeControl: true, mapTypeControlOptions: { style: MapTypeControlStyle.HORIZONTAL_BAR, position: ControlPosition.BLOCK_START_INLINE_CENTER, }, zoomControl: true, zoomControlOptions: { position: ControlPosition.INLINE_START_BLOCK_CENTER, }, scaleControl: true, streetViewControl: true, streetViewControlOptions: { position: ControlPosition.INLINE_START_BLOCK_START, }, fullscreenControl: true, }); } void init();
JavaScript
const mapElement = document.querySelector('gmp-map'); let innerMap; async function init() { // Request needed libraries. const [{ MapTypeControlStyle }, { ControlPosition }] = await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('core'), ]); // Get the inner map. innerMap = mapElement.innerMap; // Set the map's controls options. innerMap.setOptions({ mapTypeControl: true, mapTypeControlOptions: { style: MapTypeControlStyle.HORIZONTAL_BAR, position: ControlPosition.BLOCK_START_INLINE_CENTER, }, zoomControl: true, zoomControlOptions: { position: ControlPosition.INLINE_START_BLOCK_CENTER, }, scaleControl: true, streetViewControl: true, streetViewControlOptions: { position: ControlPosition.INLINE_START_BLOCK_START, }, fullscreenControl: true, }); } void init();
امتحان کردن نمونه
کنترلهای سفارشی
علاوهبر اصلاح سبک و موقعیت کنترلهای میانای برنامهسازی کاربردی موجود، میتوانید کنترلهای خودتان را برای مدیریت تعامل با کاربر ایجاد کنید. کنترلها
ابزارهایی ثابت هستند که در موقعیتهای مطلق روی نقشه شناورند، برخلاف
پوششها که با نقشه زیرین حرکت میکنند. بهطور اساسیتر، کنترل یک عنصر <div> است که موقعیت مطلق روی نقشه دارد، واسط کاربری را به کاربر نمایش میدهد، و تعامل با کاربر یا نقشه را معمولاً ازطریق گرداننده رویداد مدیریت میکند.
برای ایجاد کنترل سفارشی خودتان، چند قانون لازم است. اما دستورالعملهای زیر میتواند بهعنوان روال مطلوب عمل کند:
- CSS مناسب را برای نمایش عنصر(های) کنترل تعریف کنید.
- تعامل با کاربر یا نقشه را ازطریق کنترلکنندههای رویداد برای تغییرات ویژگی نقشه یا رویدادهای کاربر (برای مثال، رویدادهای
'click') مدیریت کنید. - عنصر
<div>را برای نگهداری کنترل ایجاد کنید و این عنصر را به ویژگیcontrolsمربوط بهMapاضافه کنید.
هرکدام از این نگرانیها در زیر مورد بحث قرار گرفته است.
کشیدن کنترلهای سفارشی
نحوه کشیدن کنترل به شما بستگی دارد. بهطور کلی، توصیه میکنیم که همه ارائه کنترل خود را در یک عنصر <div> قرار دهید تا بتوانید کنترل خود را بهعنوان یک واحد دستکاری کنید. از این الگوی طراحی در نمونههای نشاندادهشده در زیر استفاده خواهیم کرد.
طراحی کنترلهای جذاب به مقداری دانش درباره CSS و ساختار DOM نیاز دارد. نمونههای کد زیر افزودن کنترل سفارشی را بااستفاده از روشهای HTML بیانی و برنامهای نشان میدهد.
CSS اظهاری
سبکهای CSS زیر ظاهری را ارائه میدهند که با کنترلهای پیشفرض سازگار است. از این سبکها برای هر دو مثال زیر استفاده کنید:
.streetview-toggle-button { align-items: center; background: white; border: none; border-radius: 2px; box-shadow: 0 1px 4px -1px rgba(0, 0, 0, 0.3); color: rgb(86, 86, 86); cursor: pointer; display: flex; font-family: Roboto, Arial, sans-serif; font-size: 18px; font-weight: 400; height: 40px; justify-content: center; margin: 10px 0; padding: 0 17px; } .streetview-toggle-button:hover { background: #f4f4f4; color: #000; }
HTML اظهاری
این تکهکدها نحوه ایجاد کنترل سفارشی را بهصورت اعلانی نشان میدهند.
در HTML، از DIV با شناسه container برای تعیین موقعیت کنترل استفاده میشود؛ این DIV در عنصر gmp-map قرار دارد و دکمه به DIV اضافه میشود. ویژگی slot روی control-inline-start-block-start تنظیم شده است تا کنترل در گوشه بالا سمت چپ نقشه قرار گیرد.
<gmp-map
center="41.027748173921374, -92.41852445367961"
zoom="13"
map-id="DEMO_MAP_ID">
<div id="container" slot="control-inline-start-block-start">
<input type="button"
id="streetview-toggle-button"
class="button"
value="Click this button" />
</div>
</gmp-map>در جاوا اسکریپت، از getElementById() برای پیدا کردن DIV و دکمه استفاده میشود، یک شنونده رویداد به دکمه اضافه میشود، و دکمه به DIV پیوست میشود.
// Create a DIV to attach the control UI to the Map. const container = document.getElementById("container"); // Get the control button from the HTML page. const controlButton = document.getElementById("streetview-toggle-button"); // Add a click event listener. controlButton.addEventListener("click", () => { window.alert("You clicked the button!"); }); // Add the control to the DIV. container.append(controlButton);
جاوا اسکریپت برنامهنویسیشده
این تکهکد نحوه ایجاد دکمه کنترل بهصورت برنامهریزیشده را نشان میدهد. سبکهای CSS در بالا تعریف شدهاند.
// Create a DIV to attach the control UI to the Map. const container = document.getElementById("container"); // Position the control in the top left corner of the map. container.slot = "control-block-start-inline-start"; // Create the control. const controlButton = document.createElement("button"); controlButton.classList.add("streetview-toggle-button"); controlButton.textContent = "Click this button"; controlButton.type = "button"; // Add a click event listener. controlButton.addEventListener("click", () => { window.alert("You clicked the button!"); }); // Add the control to the DIV. container.append(controlButton);
مدیریت رویدادها از کنترلهای سفارشی
برای اینکه کنترل مفید باشد، باید واقعاً کاری انجام دهد. اینکه کنترل چه کاری انجام دهد به شما بستگی دارد. کنترل ممکن است به ورودی کاربر پاسخ دهد یا ممکن است به تغییرات در وضعیت Map پاسخ دهد.
برای پاسخ دادن به ورودی کاربر، از addEventListener() استفاده کنید که رویدادهای DOM پشتیبانیشده را مدیریت میکند. تکهکد زیر یک شنونده برای رویداد 'click' مرورگر اضافه میکند. توجه داشته باشید که این رویداد از DOM دریافت میشود، نه از نقشه.
// Setup the click event listener: set the map to center on Chicago var chicago = {lat: 41.850, lng: -87.650}; controlButton.addEventListener('click', () => { map.setCenter(chicago); });
کنترلهای سفارشی را دسترسپذیر کنید
برای اطمینان از اینکه کنترلها رویدادهای صفحهکلید را دریافت میکنند و بهدرستی برای صفحهخوانها نمایش داده میشوند:
- همیشه از عناصر HTML بومی برای دکمهها، عناصر فرم، و برچسبها استفاده کنید. فقط از عنصر DIV بهعنوان محفظهای برای نگهداری کنترلهای بومی استفاده کنید؛ هرگز از DIV بهعنوان عنصر میانای کاربر تعاملی استفاده نکنید.
- از عنصر
label، مشخصهtitle، یا مشخصهaria-labelدر جاهای مناسب استفاده کنید تا اطلاعاتی درباره عنصر میانای کاربر ارائه دهید.
کنترلهای سفارشی موقعیت
از مشخصه slot برای تعیین موقعیت کنترلهای سفارشی استفاده کنید و موقعیت کنترل موردنیاز را مشخص کنید.
برای اطلاعات بیشتر درباره این موقعیتها، به موقعیت کنترل
در بالا مراجعه کنید.
هر ControlPosition یک MVCArray از
کنترلهای نمایشدادهشده در آن جایگاه را ذخیره میکند. درنتیجه، وقتی کنترلها به جایگاه اضافه یا از آن برداشته میشوند،
میانای برنامهسازی کاربردی کنترلها را مطابق با آن بهروز میکند.
کد زیر یک کنترل سفارشی جدید ایجاد میکند (سازنده آن نشان داده نشده است) و آن را در موقعیت BLOCK_START_INLINE_END (بالا سمت راست در بافت چپ به راست) به نقشه اضافه میکند.
// Create a DIV to attach the control UI to the Map.
const centerControlDiv = document.createElement("div");
// Create the control. This code calls a function that
// creates a new instance of a button control.
const centerControl = createCenterControl(map);
// Append the control to the DIV.
centerControlDiv.appendChild(centerControl);
// Push the control to the BLOCK_START_INLINE_END position.
innerMap.controls[google.maps.ControlPosition.BLOCK_START_INLINE_END].push(centerControlDiv);برای تنظیم موقعیت کنترل سفارشی بهصورت اعلانی، مشخصه slot را در
HTML تنظیم کنید:
<gmp-map center="30.72851568848909, -81.54675994068873" zoom="12">
<div slot="control-block-start-inline-end">
<!-- Control HTML -->
</div>
</gmp-map>نمونه کنترل سفارشی
کنترل زیر ساده است (هرچند چندان مفید نیست) و
الگوهای نشاندادهشده در بالا را ترکیب میکند. این کنترل به رویدادهای DOM
'click' با قرار دادن نقشه در مرکز در یک مکان پیشفرض خاص
پاسخ میدهد:
TypeScript
const chicago = { lat: 41.85, lng: -87.65 }; // Get the gmp-map element const mapElement = document.querySelector('gmp-map')!; async function init() { (await google.maps.importLibrary('maps')) as typeof google.maps; // Get the inner map. const innerMap = mapElement.innerMap; // Get the button element from the HTML const centerButton = document.getElementById( 'btnCenterMap' ) as HTMLButtonElement; // Move the event listener here centerButton.addEventListener('click', () => { innerMap.setCenter(chicago); }); } void init();
JavaScript
const chicago = { lat: 41.85, lng: -87.65 }; // Get the gmp-map element const mapElement = document.querySelector('gmp-map'); async function init() { await google.maps.importLibrary('maps'); // Get the inner map. const innerMap = mapElement.innerMap; // Get the button element from the HTML const centerButton = document.getElementById('btnCenterMap'); // Move the event listener here centerButton.addEventListener('click', () => { innerMap.setCenter(chicago); }); } void init();
امتحان کردن نمونه
افزودن وضعیت به کنترلها
کنترلها ممکن است وضعیت را نیز ذخیره کنند. مثال زیر مشابه مثالی است که قبلاً نشان داده شد، اما کنترل حاوی دکمه اضافی «تنظیم خانه» است که کنترل را برای نمایش مکان خانه جدید تنظیم میکند. این کار را با ایجاد یک
home_ ویژگی در کنترل برای ذخیره این حالت و
ارائه گیرندهها و تنظیمکنندهها برای آن حالت انجام میدهیم.
TypeScript
let innerMap: google.maps.Map; const mapElement = document.querySelector('gmp-map')!; let center: google.maps.LatLngLiteral | google.maps.LatLng = { lat: 41.85, lng: -87.65, }; async function init() { await google.maps.importLibrary('maps'); innerMap = mapElement.innerMap; // Get the button UI elements. const centerMapButton = document.getElementById( 'btnCenterMap' ) as HTMLInputElement; const setCenterButton = document.getElementById( 'btnSetCenter' ) as HTMLInputElement; // Set up the click event listener for the 'Center Map' button. Set the map // to the currently stored center. centerMapButton.addEventListener('click', () => { const currentCenter = center; innerMap.setCenter(currentCenter); }); // Set up the click event listener for 'Set Center': Set the center of // the control to the current center of the map. setCenterButton.addEventListener('click', () => { const newCenter = innerMap.getCenter(); if (newCenter) { center = newCenter; } }); } void init();
JavaScript
let innerMap; const mapElement = document.querySelector('gmp-map'); let center = { lat: 41.85, lng: -87.65, }; async function init() { await google.maps.importLibrary('maps'); innerMap = mapElement.innerMap; // Get the button UI elements. const centerMapButton = document.getElementById('btnCenterMap'); const setCenterButton = document.getElementById('btnSetCenter'); // Set up the click event listener for the 'Center Map' button. Set the map // to the currently stored center. centerMapButton.addEventListener('click', () => { const currentCenter = center; innerMap.setCenter(currentCenter); }); // Set up the click event listener for 'Set Center': Set the center of // the control to the current center of the map. setCenterButton.addEventListener('click', () => { const newCenter = innerMap.getCenter(); if (newCenter) { center = newCenter; } }); } void init();