CKTIS / HTML
ismap — serverseitige Imagemap
Das boolesche Attribut `ismap` auf `img` kennzeichnet eine serverseitige Imagemap. Das Bild muss sich in einem `a`-Element mit `href` befinden. Beim Anklicken hängt der Browser Koordinaten an die Link-URL an; deren Auswertung ist Aufgabe des Servers.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<a href="/map"><img src="map.png" alt="Map" ismap></a>ismap ist ein boolesches Attribut von img. Es darf nur angegeben werden, wenn das Bild ein a-Element mit einem href-Attribut als Vorfahren hat. Sein Vorhandensein aktiviert den Mechanismus für serverseitige Imagemaps; Bereiche oder deren Ziele werden dadurch nicht im Dokument festgelegt.
Beim Anklicken des Bildes hängt der Browser den Zusatz ?x,y an die Link-URL an. Die Koordinaten werden als Dezimalzahlen ohne Nachkommastellen angegeben und in CSS-Pixeln ab der linken oberen Ecke des Bildes gemessen, nicht in Pixeln der Quelldatei. Negative Werte werden auf null begrenzt. Bei einem nicht vertrauenswürdigen Ereignis, etwa einem durch ein Skript ausgelösten, verwendet der Algorithmus 0,0.
Gültige Schreibweisen sind ismap, ismap="" und ismap="ismap". Die Schreibweise ismap="false" ist ungültig und deaktiviert den Mechanismus nicht: Das Attribut ist weiterhin vorhanden. Um ihn zu deaktivieren, entfernen Sie das Attribut.
Anders als usemap, das auf eine clientseitige Map verweist, sendet ismap Koordinaten an den Server. Der Server muss sie auswerten und eine Antwort auswählen. Stellen Sie außerdem Textlinks zu denselben Funktionen bereit, damit die Auswahl kein präzises Zielen auf das Bild erfordert.
Im Beispiel verweist der Link auf #result, und der Klick-Handler ruft event.preventDefault() auf, um die Navigation zu verhindern. Das Beispiel zeigt, wie die DOM-Eigenschaft isMap das Attribut ismap widerspiegelt: Ihr Anfangswert ist true. Wird sie auf false gesetzt, verschwindet das Attribut; wird der Anfangswert wiederhergestellt, wird es erneut hinzugefügt. Beim Klicken wird keine Anfrage mit Koordinaten gesendet.
Beispiele
<!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>Ergebnis
Inside a link with href: true Image map enabled: true ismap present after setting isMap to false: false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.