Para tornar os marcadores mais acessíveis, ative o processamento de eventos de clique, adicione texto descritivo para leitores de tela e ajuste a escala do marcador.
- Quando um marcador é clicável, ele pode responder ao teclado e ao mouse.
- O texto especificado na opção de título pode ser lido por leitores de tela e aparece quando um usuário mantém o ponteiro do mouse sobre o marcador.
- Aumentar o tamanho do marcador reduz a precisão necessária para interagir com ele em todos os dispositivos — especialmente, em dispositivos sensíveis ao toque — e melhora a acessibilidade. Os marcadores padrão atendem ao padrão de tamanho mínimo de WCAG AA, mas para desenvolvedores que buscam cumprir com o padrão de tamanho da área de WCAG AAA, o tamanho do marcador deve ser aumentado.
Confira a personalização básica de marcadores para saber como mudar a escala, adicionar texto ao título e muito mais.
Confira no exemplo a seguir um mapa com cinco marcadores clicáveis e focalizáveis que incluem texto de título e foram definidos para uma escala de 1,5x:
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>
Testar amostra
Faça o seguinte para navegar pelos marcadores usando o teclado:
- Use a tecla Tab para selecionar o primeiro marcador. Se houver vários marcadores no mesmo mapa, use as teclas de seta para mover entre eles.
- Se o marcador for clicável, pressione a tecla Enter para clicar. Se ele tiver uma janela de informações, abra-o clicando ou pressionando a tecla Enter ou a barra de espaço. O foco retorna ao marcador associado quando a janela de informações é fechada.
- Pressione "Tab" novamente para passar a outros controles do mapa.
Para melhorar a acessibilidade:
- Defina o texto descritivo de um marcador usando a opção
Marker3DInteractiveElement.title
. - Adicione conteúdo ao espaço
header
dePopoverElement
. - Aumente a escala do marcador usando a propriedade
PinElement.scale
.