CKTIS / HTML
ismap — server-side-afbeeldingskaart
Het booleaanse attribuut `ismap` op `img` geeft een server-side-afbeeldingskaart aan. De afbeelding moet in een `a`-element met `href` staan. Wanneer erop wordt geklikt, voegt de browser coördinaten toe aan de link-URL; de server is verantwoordelijk voor de interpretatie ervan.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<a href="/map"><img src="map.png" alt="Map" ismap></a>ismap is een booleaans attribuut van img. Het mag alleen worden opgegeven als de afbeelding een a-element met een href-attribuut als voorouder heeft. De aanwezigheid ervan activeert het mechanisme voor server-side-afbeeldingskaarten; gebieden en hun bestemmingen worden er niet mee in het document vastgelegd.
Wanneer op de afbeelding wordt geklikt, voegt de browser het achtervoegsel ?x,y toe aan de link-URL. Coördinaten worden weergegeven als decimale gehele getallen en gemeten in CSS-pixels vanaf de linkerbovenhoek van de afbeelding, niet in pixels van het bronbestand. Negatieve waarden worden op nul begrensd. Bij een niet-vertrouwde gebeurtenis, bijvoorbeeld een gebeurtenis die door een script is geactiveerd, gebruikt het algoritme 0,0.
Geldige vormen zijn ismap, ismap="" en ismap="ismap". ismap="false" schrijven is ongeldig en schakelt het mechanisme niet uit: het attribuut is nog steeds aanwezig. Verwijder het attribuut om het uit te schakelen.
Anders dan usemap, dat verwijst naar een client-side-kaart, stuurt ismap coördinaten naar de server. De server moet ze interpreteren en een antwoord kiezen. Bied ook tekstlinks naar dezelfde functies aan, zodat de keuze geen nauwkeurig richten op de afbeelding vereist.
In het voorbeeld verwijst de link naar #result en roept de klikhandler event.preventDefault() aan om navigatie te voorkomen. Het voorbeeld laat zien hoe de DOM-eigenschap isMap het attribuut ismap weerspiegelt: de beginwaarde is true, instellen op false verwijdert het attribuut en het herstellen van de beginwaarde voegt het weer toe. Een klik verstuurt geen verzoek met coördinaten.
Voorbeelden
<!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>Resultaat
Inside a link with href: true Image map enabled: true ismap present after setting isMap to false: false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.