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

CKTIS / HTML

ismap — mapa de imagem do lado do servidor

O atributo booleano `ismap` de `img` indica um mapa de imagem do lado do servidor. A imagem tem de estar dentro de um elemento `a` com `href`. Ao clicar, o navegador acrescenta as coordenadas ao URL da ligação; interpretá-las é da responsabilidade do servidor.

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

Sintaxe

<a href="/map"><img src="map.png" alt="Map" ismap></a>

ismap é um atributo booleano de img. Só pode ser especificado se a imagem tiver como antecessor um elemento a com um atributo href. A sua presença ativa o mecanismo de mapa de imagem do lado do servidor; não define áreas nem os respetivos destinos no documento.

Ao clicar na imagem, o navegador acrescenta o sufixo ?x,y ao URL da ligação. As coordenadas são expressas como números inteiros decimais e medidas em píxeis CSS a partir do canto superior esquerdo da imagem, e não em píxeis do ficheiro de origem. Os valores negativos são limitados a zero. Para um evento não fidedigno, por exemplo, acionado por um script, o algoritmo utiliza 0,0.

As formas válidas são ismap, ismap="" e ismap="ismap". Escrever ismap="false" é inválido e não desativa o mecanismo: o atributo continua presente. Para o desativar, remova o atributo.

Ao contrário de usemap, que faz referência a um mapa do lado do cliente, ismap envia coordenadas para o servidor. O servidor tem de as interpretar e escolher uma resposta. Disponibilize também ligações de texto para as mesmas funções, para que a seleção não exija apontar com precisão para a imagem.

No exemplo, a ligação aponta para #result e a função que trata o evento de clique chama event.preventDefault() para impedir a navegação. O exemplo mostra como a propriedade isMap do DOM reflete o atributo ismap: o seu valor inicial é true, defini-la como false remove o atributo e repor o valor inicial volta a adicioná-lo. Ao clicar, não é enviado nenhum pedido com coordenadas.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Server-side image map attribute</title>
</head>
<body>
  <a id="map-link" href="#result"><img id="map-image" ismap width="80" height="40" alt="Sample server-side image map" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='80' height='40'%3E%3Crect width='80' height='40' fill='steelblue'/%3E%3C/svg%3E"></a>
  <pre id="result"></pre>
  <script>
    const image = document.getElementById('map-image');
    const link = image.closest('a[href]');
    link.addEventListener('click', event => event.preventDefault());
    const enabled = image.isMap;
    image.isMap = false;
    const presentAfterClearing = image.hasAttribute('ismap');
    image.isMap = enabled;
    document.getElementById('result').textContent = [
      `Inside a link with href: ${Boolean(link)}`,
      `Image map enabled: ${enabled}`,
      `ismap present after setting isMap to false: ${presentAfterClearing}`
    ].join('\n');
  </script>
</body>
</html>

Resultado

Inside a link with href: true
Image map enabled: true
ismap present after setting isMap to false: false

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