CKTIS / HTML
shape — Geometrie eines Bildkartenbereichs
Das Attribut shape von area legt die Geometrie eines Bildkartenbereichs fest. Für rect, circle und poly ist coords erforderlich; default umfasst das ganze Bild.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<area shape="rect|circle|poly|default" ...>shape ist ein enumeriertes Attribut eines area-Elements innerhalb von map. Ein Bild wird über usemap="#name" mit der Karte verbunden, wobei auf deren name verwiesen wird. Die Form legt einen interaktiven Bereich fest; sie zeichnet keine sichtbare Figur.
Für rect müssen in coords genau vier Ganzzahlen stehen: x1,y1,x2,y2, wobei x1 < x2 und y1 < y2 gilt. Für circle werden x,y,r angegeben: Mittelpunkt und ein nicht negativer Radius; ein Radius von null ergibt einen leeren Bereich. Für poly ist eine gerade Anzahl von mindestens sechs Ganzzahlen erforderlich, die aufeinanderfolgende Eckpunkte beschreiben. Die Koordinaten werden in CSS-Pixeln vom linken oberen Rand des angezeigten Bildes aus gemessen; eine Größenänderung des Bildes skaliert sie nicht automatisch.
default umfasst das gesamte Bild und erfordert, dass coords weggelassen wird. Fehlt shape oder ist sein Wert ungültig, gilt rect, nicht default. Die historischen Werte circ, polygon und rectangle werden erkannt, entsprechen aber nicht den Anforderungen an Autoren.
Bei überlappenden Bereichen hat das frühere area Vorrang. Deshalb sollte ein default-Bereich als Auffangbereich zuletzt stehen. Für einen Link mit href sollte ein aussagekräftiger alt-Text angegeben werden.
Beispiele
<!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>Ergebnis
Loaded image: 200 × 100 rect | coords: 0,0,100,100 | destination: #left default | coords: (none) | destination: #rest
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.