Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

ismap — mappa immagine lato server

L’attributo booleano `ismap` di `img` indica una mappa immagine lato server. L’immagine deve trovarsi all’interno di un elemento `a` con `href`. Quando si fa clic, il browser aggiunge le coordinate all’URL del collegamento; interpretarle è compito del server.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

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

ismap è un attributo booleano di img. Può essere specificato solo se l’immagine ha come antenato un elemento a con un attributo href. La sua presenza attiva il meccanismo della mappa immagine lato server; non definisce aree né le relative destinazioni nel documento.

Quando si fa clic sull’immagine, il browser aggiunge il suffisso ?x,y all’URL del collegamento. Le coordinate sono espresse come numeri interi decimali e misurate in pixel CSS dall’angolo superiore sinistro dell’immagine, non in pixel del file sorgente. I valori negativi vengono limitati a zero. Per un evento non attendibile, ad esempio attivato da uno script, l’algoritmo usa 0,0.

Le forme valide sono ismap, ismap="" e ismap="ismap". Scrivere ismap="false" è invalido e non disattiva il meccanismo: l’attributo è comunque presente. Per disattivarlo, rimuovi l’attributo.

A differenza di usemap, che fa riferimento a una mappa lato client, ismap invia le coordinate al server. Il server deve interpretarle e scegliere una risposta. Fornisci anche collegamenti testuali alle stesse funzioni, così la scelta non richiede di puntare con precisione sull’immagine.

Nell’esempio, il collegamento punta a #result e il gestore dell’evento di clic chiama event.preventDefault() per impedire la navigazione. L’esempio mostra come la proprietà DOM isMap rifletta l’attributo ismap: il suo valore iniziale è true, impostarla su false rimuove l’attributo e ripristinare il valore iniziale lo aggiunge di nuovo. Il clic non invia alcuna richiesta contenente coordinate.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti