Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

ismap — mapa de imagen del lado del servidor

El atributo booleano `ismap` de `img` indica que se trata de un mapa de imagen del lado del servidor. La imagen debe estar dentro de un elemento `a` con `href`. Al hacer clic, el navegador añade las coordenadas a la URL del enlace; interpretarlas es responsabilidad del servidor.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<a href="/map"><img src="map.png" alt="Map" ismap></a>

ismap es un atributo booleano de img. Solo se puede especificar si la imagen tiene como antecesor un elemento a con un atributo href. Su presencia activa el mecanismo de mapa de imagen del lado del servidor; no define regiones ni sus destinos en el documento.

Al hacer clic en la imagen, el navegador añade el sufijo ?x,y a la URL del enlace. Las coordenadas se expresan como números enteros decimales y se miden en píxeles CSS desde la esquina superior izquierda de la imagen, no en píxeles del archivo de origen. Los valores negativos se limitan a cero. Para un evento no confiable, como uno activado por un script, el algoritmo usa 0,0.

Las formas válidas son ismap, ismap="" e ismap="ismap". Escribir ismap="false" no es válido y no desactiva el mecanismo: el atributo sigue presente. Para desactivarlo, elimina el atributo.

A diferencia de usemap, que hace referencia a un mapa del lado del cliente, ismap envía coordenadas al servidor. El servidor debe interpretarlas y elegir una respuesta. Proporciona también enlaces de texto a las mismas funciones, para que elegir no requiera apuntar con precisión a la imagen.

En el ejemplo, el enlace apunta a #result y el controlador del evento de clic llama a event.preventDefault() para impedir la navegación. El ejemplo muestra cómo la propiedad isMap del DOM refleja el atributo ismap: su valor inicial es true, asignarle false elimina el atributo y restaurar el valor inicial vuelve a añadirlo. Al hacer clic no se envía ninguna solicitud con coordenadas.

Ejemplos

<!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>

Resultado

Inside a link with href: true
Image map enabled: true
ismap present after setting isMap to false: false

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.

Fuentes