Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

map — áreas com ligações numa imagem

O elemento `map`, em conjunto com `img` e elementos `area` descendentes, cria um mapa de imagem: áreas geométricas podem ligar a destinos diferentes.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<img src="image.png" alt="Description" usemap="#navigation">
<map name="navigation">
  <area shape="rect" coords="0,0,100,50" href="#destination" alt="Destination">
</map>

map define um mapa de imagem em conjunto com img e elementos area descendentes. O atributo usemap="#navigation" da imagem referencia o name="navigation" do mapa. O próprio elemento map não desenha a imagem.

O atributo name é obrigatório: tem de ser não vazio, não conter espaços em branco ASCII e ser único entre os nomes dos mapas na mesma árvore. Se também for indicado id, tem de ter o mesmo valor. São necessárias ambas as etiquetas map. O seu modelo de conteúdo transparente significa que o conteúdo permitido depende do contexto do elemento-pai.

Um elemento area define uma área através de shape e coords, e o respetivo destino através de href. Inclua uma descrição da imagem em alt do elemento img e o texto do destino em alt de cada área com ligação. Uma ligação de texto normal é uma opção de navegação adicional útil.

As coordenadas são medidas em píxeis CSS relativamente à imagem apresentada; redimensioná-la não ajusta automaticamente os valores de coords. No DOM, HTMLMapElement.areas expõe uma HTMLCollection dos elementos area descendentes.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Image map</title>
<img width="200" height="80" alt="Blue navigation panel" usemap="#navigation"
     src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='80'%3E%3Cpath fill='royalblue' d='M0 0h200v80H0z'/%3E%3C/svg%3E">
<map name="navigation" id="navigation">
  <area shape="rect" coords="0,0,200,80" href="#destination" alt="Destination">
</map>
<p><a href="#destination">Destination</a></p>
<h2 id="destination">Destination</h2>
</html>

Resultado

A blue 200 × 80 CSS-pixel image, a Destination text link, and a Destination heading. Activating the image region or text link navigates to #destination.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes