CKTIS / HTML
shape — geometría de un área de mapa de imagen
El atributo shape de area selecciona la geometría de una región de un mapa de imagen. Los valores rect, circle y poly requieren coords; default cubre toda la imagen.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<area shape="rect|circle|poly|default" ...>shape es un atributo enumerado de un elemento area dentro de map. Una imagen se conecta al mapa mediante usemap="#name", que hace referencia a su name. La forma define una región interactiva; no dibuja una figura visible.
Para rect, indica exactamente cuatro números enteros en coords: x1,y1,x2,y2, donde x1 < x2 y y1 < y2. Para circle, indica x,y,r: el centro y un radio no negativo; un radio igual a cero produce una región vacía. Para poly, indica un número par de enteros, al menos seis, que describan vértices consecutivos. Las coordenadas se expresan en píxeles CSS desde la esquina superior izquierda de la imagen mostrada; cambiar el tamaño de la imagen no las escala automáticamente.
default cubre toda la imagen y requiere omitir coords. Si se omite shape o su valor no es válido, se usa rect, no default. Se reconocen los valores históricos circ, polygon y rectangle, pero no son conformes para los autores.
Cuando las regiones se superponen, tiene prioridad el area anterior; por tanto, coloca al final una región default de reserva. Para un enlace con href, proporciona un texto alt descriptivo.
Ejemplos
<!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>Resultado
Loaded image: 200 × 100 rect | coords: 0,0,100,100 | destination: #left default | coords: (none) | destination: #rest
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.