CKTIS / HTML
shape — geometrie oblasti obrazové mapy
Atribut shape prvku area určuje geometrii oblasti obrazové mapy. Hodnoty rect, circle a poly vyžadují coords; default pokrývá celý obrázek.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<area shape="rect|circle|poly|default" ...>shape je výčtový atribut prvku area uvnitř prvku map. Obrázek se propojí s mapou pomocí usemap="#name", které odkazuje na její name. Tvar určuje interaktivní oblast; nekreslí viditelný obrazec.
Pro rect zadejte do coords přesně čtyři celá čísla: x1,y1,x2,y2, přičemž platí x1 < x2 a y1 < y2. Pro circle zadejte x,y,r: střed a nezáporný poloměr; nulový poloměr vytvoří prázdnou oblast. Pro poly zadejte sudý počet celých čísel, nejméně šest, která popisují po sobě jdoucí vrcholy. Souřadnice jsou v CSS pixelech od levého horního rohu zobrazeného obrázku; změna velikosti obrázku je automaticky nepřepočítá.
default pokrývá celý obrázek a vyžaduje vynechání coords. Pokud shape chybí nebo má neplatnou hodnotu, použije se rect, nikoli default. Historické hodnoty circ, polygon a rectangle se rozpoznávají, ale nejsou v souladu s požadavky na autory.
Při překryvu oblastí má přednost dřívější area; záložní oblast default proto umístěte jako poslední. U odkazu s href uveďte výstižný text alt.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Rectangle and default image-map regions</title>
</head>
<body>
<img id="diagram" width="200" height="100" usemap="#zones"
alt="Two-color diagram with a left region and a fallback region"
src="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%22200%22%20height%3D%22100%22%3E%3Cpath%20fill%3D%22gold%22%20d%3D%22M0%200h200v100H0z%22%2F%3E%3Cpath%20fill%3D%22skyblue%22%20d%3D%22M0%200h100v100H0z%22%2F%3E%3C%2Fsvg%3E">
<map name="zones">
<area shape="rect" coords="0,0,100,100" href="#left" alt="Left region">
<area shape="default" href="#rest" alt="Fallback region">
</map>
<p id="left">Left region</p>
<p id="rest">Fallback region</p>
<script>
const image = document.getElementById('diagram');
const map = document.querySelector('map[name="' + image.useMap.slice(1) + '"]');
const areas = map.querySelectorAll('area');
for (const area of areas) {
for (const type of ['click', 'auxclick']) {
area.addEventListener(type, event => event.preventDefault());
}
}
image.decode().then(() => {
console.log('Loaded image: ' + image.naturalWidth + ' × ' + image.naturalHeight);
for (const area of areas) {
console.log(area.shape + ' | coords: ' + (area.coords || '(none)') + ' | destination: ' + area.hash);
}
});
</script>
</body>
</html>Výsledek
Loaded image: 200 × 100 rect | coords: 0,0,100,100 | destination: #left default | coords: (none) | destination: #rest
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.