মার্কার অ্যাক্সেসযোগ্য করে তোলা

ক্লিক ইভেন্ট হ্যান্ডলিং চালু করে, স্ক্রিন রিডারের জন্য বর্ণনামূলক টেক্সট যোগ করে এবং মার্কার স্কেল অ্যাডজাস্ট করে আপনি মার্কারকে আরও অ্যাক্সেসযোগ্য করে তুলতে পারেন।

• কোনও মার্কার ক্লিক করার মতো হলে, এটি কীবোর্ড ও মাউস ইনপুটে রেসপন্স করতে পারে।
• টাইটেল বিকল্পে উল্লেখ করা টেক্সট স্ক্রিন রিডার পড়তে পারে এবং ব্যবহারকারী মার্কারের উপর মাউস পয়েন্টার নিয়ে গেলে এটি দেখা যাবে।
• মার্কারের সাইজ বাড়ালে, সব ডিভাইসে — বিশেষ করে টাচস্ক্রিন ডিভাইসে — এটির সাথে ইন্টার‍্যাক্ট করার জন্য প্রয়োজনীয় নির্ভুলতা কমে যায় এবং অ্যাক্সেসিবিলিটি উন্নত হয়। ডিফল্ট মার্কার WCAG AA ন্যূনতম সাইজ স্ট্যান্ডার্ড পূরণ করে, তবে যেসব ডেভেলপার WCAG AAA টার্গেট সাইজ স্ট্যান্ডার্ড মেনে চলতে চান তাদের মার্কারের সাইজ আরও বড় করতে হবে।

মার্কার স্কেল কীভাবে পরিবর্তন করবেন, শিরোনামের টেক্সট কীভাবে যোগ করবেন এবং আরও অনেক কিছু জানতে বেসিক মার্কার কাস্টমাইজেশন দেখুন।

নিচের উদাহরণে ক্লিক করা যায় ও ফোকাস করা যায় এমন পাঁচটি মার্কার সহ একটি ম্যাপ দেখানো হয়েছে যেগুলিতে শীর্ষক টেক্সট রয়েছে এবং ১.৫x স্কেলে সেট করা হয়েছে:

জাভাস্ক্রিপ্ট

async function init() {
    // Import the needed libraries.
    const [{ Marker3DInteractiveElement, PopoverElement }, { PinElement }] =
        await Promise.all([
            google.maps.importLibrary('maps3d'),
            google.maps.importLibrary('marker'),
        ]);

    const map3DElement = document.querySelector('gmp-map-3d');

    // Set LatLng and title text for the markers. The first marker (Boynton Pass)
    // receives the initial focus when tab is pressed. Use arrow keys to move
    // between markers; press tab again to cycle through the map controls.
    const tourStops = [
        {
            position: { lat: 34.8791806, lng: -111.8265049 },
            title: 'Boynton Pass',
        },
        {
            position: { lat: 34.8559195, lng: -111.7988186 },
            title: 'Airport Mesa',
        },
        {
            position: { lat: 34.832149, lng: -111.7695277 },
            title: 'Chapel of the Holy Cross',
        },
        {
            position: { lat: 34.823736, lng: -111.8001857 },
            title: 'Red Rock Crossing',
        },
        {
            position: { lat: 34.800326, lng: -111.7665047 },
            title: 'Bell Rock',
        },
    ];

    tourStops.forEach(({ position, title }, i) => {
        const pin = new PinElement({
            glyphText: String(i + 1),
            scale: 1.5,
            glyphColor: '#FFFFFF',
        });
        const popover = new PopoverElement();

        const content = `${String(i + 1)}. ${title}`;
        const header = document.createElement('span');
        // Include the label for screen readers.
        header.ariaLabel = `This is marker ${String(i + 1)}. ${title}`;
        header.slot = 'header';

        popover.append(header);
        popover.append(content);

        const interactiveMarker = new Marker3DInteractiveElement({
            // Include a title, used for accessibility text for use by screen readers.
            title,
            position,
            gmpPopoverTargetElement: popover,
        });

        interactiveMarker.append(pin);

        map3DElement.append(interactiveMarker);
        map3DElement.append(popover);
    });

    document.body.append(map3DElement);
}

void init();
index.js

CSS

/* 
 * Always set the map height explicitly to define the size of the div element
 * that contains the map. 
 */
html,
map {
    height: 100%;
}
body {
    height: 100%;
    margin: 0;
    padding: 0;
}
style.css

HTML

<html>
    <head>
        <title>Map</title>

        <link rel="stylesheet" type="text/css" href="./style.css" />
        <script type="module" src="./index.js"></script>
        <script>
            // prettier-ignore
            (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
                key: "GOOGLE_MAPS_API_KEY"
            });
        </script>
    </head>
    <body>
        <gmp-map-3d
            center="34.8405,-111.7909,1322.7"
            range="13279.5"
            tilt="67.44"
            heading="0.01"
            mode="satellite"
            gesture-handling="cooperative"></gmp-map-3d>
    </body>
</html>
index.html

কীবোর্ড ব্যবহার করে মার্কার নেভিগেট করতে:

1. প্রথম মার্কারের উপর ফোকাস করতে Tab কী ব্যবহার করুন; একই ম্যাপে একাধিক মার্কার থাকলে মার্কারগুলির মধ্যে দিয়ে সাইকেল করতে তীরচিহ্ন কী ব্যবহার করুন।
2. মার্কারটি ক্লিক করা যায় এমন হলে, enter কী টিপে "ক্লিক করুন"। কোনও মার্কারের তথ্য উইন্ডো থাকলে, আপনি ক্লিক করে অথবা Enter কী বা Space বার প্রেস করে এটি খুলতে পারবেন। তথ্য উইন্ডো বন্ধ হয়ে গেলে, ফোকাস আবার সংশ্লিষ্ট মার্কারের উপর ফিরে আসবে।
3. ম্যাপের বাকি কন্ট্রোলগুলি দেখতে ট্যাব আবার প্রেস করুন।

অ্যাক্সেসিবিলিটি উন্নত করতে:

• Marker3DInteractiveElement.title বিকল্প ব্যবহার করে মার্কারের জন্য বর্ণনামূলক টেক্সট সেট করুন।
• PopoverElement-এর header স্লটে কন্টেন্ট যোগ করুন।
• PinElement.scale প্রপার্টি ব্যবহার করে মার্কার স্কেল বাড়ান।