Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

ismap — image cliquable côté serveur

L’attribut booléen `ismap` de `img` indique une image cliquable côté serveur. L’image doit se trouver dans un élément `a` doté de `href`. Lorsqu’on clique dessus, le navigateur ajoute les coordonnées à l’URL du lien ; leur interprétation relève du serveur.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

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

ismap est un attribut booléen de img. Il ne peut être spécifié que si l’image a pour ancêtre un élément a doté d’un attribut href. Sa présence active le mécanisme d’image cliquable côté serveur ; elle ne définit pas dans le document des zones ni leurs destinations.

Lorsque l’image est cliquée, le navigateur ajoute le suffixe ?x,y à l’URL du lien. Les coordonnées sont exprimées sous forme d’entiers décimaux et mesurées en pixels CSS depuis le coin supérieur gauche de l’image, et non en pixels du fichier source. Les valeurs négatives sont ramenées à zéro. Pour un événement non fiable, par exemple déclenché par un script, l’algorithme utilise 0,0.

Les formes valides sont ismap, ismap="" et ismap="ismap". Écrire ismap="false" est invalide et ne désactive pas le mécanisme : l’attribut est toujours présent. Pour le désactiver, supprimez l’attribut.

Contrairement à usemap, qui fait référence à une carte côté client, ismap envoie les coordonnées au serveur. Celui-ci doit les interpréter et choisir une réponse. Fournissez également des liens textuels vers les mêmes fonctions afin que le choix ne nécessite pas de viser précisément l’image.

Dans l’exemple, le lien pointe vers #result et le gestionnaire de clic appelle event.preventDefault() pour empêcher la navigation. L’exemple montre comment la propriété DOM isMap reflète l’attribut ismap : elle vaut initialement true, la passer à false supprime l’attribut et rétablir sa valeur initiale le rajoute. Un clic n’envoie aucune requête contenant des coordonnées.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources