クリック イベントの処理を有効にして、スクリーン リーダー用の説明テキストを追加し、マーカーのスケールを調整することで、マーカーのアクセシビリティを高めることができます。
- マーカーは、クリック可能に設定することで、キーボードやマウスでの入力に反応させることができます。
- タイトル オプションで指定したテキストはスクリーン リーダーの読み取り対象になり、ユーザーがマウスポインタをマーカーに合わせると表示されます。
- マーカーのサイズを拡大すると、すべてのデバイス(特にタッチスクリーン式のデバイス)で、マーカーを操作する際の精度は低下しますが、使いやすさは向上します。デフォルトのマーカーは WCAG の標準最小サイズ(AA)を満たしていますが、WCAG の目標サイズ(AAA)を満たすには、マーカーのサイズを縮小する必要があります。
マーカーのスケールを変更する方法や見出しテキストを追加する方法は、マーカーの基本的なカスタマイズをご覧ください。
次の例では、クリック可能かつフォーカス可能なマーカーが地図に 5 つ表示されています。このマーカーには見出しテキストがあり、スケールが 1.5 倍に設定されています。
JavaScript
async function initMap() { const { Map3DElement, Marker3DInteractiveElement, PopoverElement } = await google.maps.importLibrary("maps3d"); const { PinElement } = await google.maps.importLibrary("marker"); const map = new Map3DElement({ center: { lat: 34.8405, lng: -111.7909, altitude: 1322.70 }, range: 13279.50, tilt: 67.44, heading: 0.01, mode: 'SATELLITE' }); // 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({ glyph: `${i + 1}`, scale: 1.5, glyphColor: "#FFFFFF" }); const popover = new PopoverElement(); const content = `${i + 1}. ${title}`; const header = document.createElement('span'); // Include the label for screen readers. header.ariaLabel = `This is marker ${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); map.append(interactiveMarker); map.append(popover); }); document.body.append(map); } initMap();
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; }
HTML
<html> <head> <title>Map</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div id="map"></div> <!-- prettier-ignore --> <script>(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: "AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8", v: "beta",});</script> </body> </html>
サンプルを試す
キーボードでマーカーを操作する方法:
- Tab キーを押して 1 つ目のマーカーにフォーカスを合わせましょう。地図内にマーカーが複数ある場合、矢印キーでマーカー間を移動できます。
- マーカーがクリック可能な場合、Enter キーで「クリック」することができます。情報ウィンドウを持つマーカーは、クリックするか、Enter または Space キーを押せばウィンドウが表示されます。情報ウィンドウが閉じると、関連付けられたマーカーにフォーカスが戻ります。
- 地図上の他のコントロール間を移動するには Tab キーをもう一度押します。
アクセシビリティを高めるには:
Marker3DInteractiveElement.title
オプションを使用してマーカーの説明テキストを設定します。PopoverElement
のheader
スロットにコンテンツを追加します。PinElement.scale
プロパティを使用してマーカーのスケールを高めます。