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

CKTIS / HTML

shape — géométrie d’une zone de carte d’image

L’attribut shape de area définit la géométrie d’une zone de carte d’image. Les valeurs rect, circle et poly nécessitent coords ; default couvre toute l’image.

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

Syntaxe

<area shape="rect|circle|poly|default" ...>

shape est un attribut énuméré d’un élément area situé dans map. Une image est associée à la carte au moyen de usemap="#name", qui référence son name. La forme définit une zone interactive ; elle ne dessine pas de figure visible.

Pour rect, fournissez exactement quatre entiers dans coords : x1,y1,x2,y2, avec x1 < x2 et y1 < y2. Pour circle, fournissez x,y,r : le centre et un rayon non négatif ; un rayon nul produit une zone vide. Pour poly, fournissez un nombre pair d’entiers, au moins six, décrivant des sommets successifs. Les coordonnées sont exprimées en pixels CSS depuis le coin supérieur gauche de l’image affichée ; le redimensionnement de l’image ne les met pas automatiquement à l’échelle.

default couvre toute l’image et nécessite d’omettre coords. Si shape est absent ou si sa valeur est invalide, la forme utilisée est rect, et non default. Les valeurs historiques circ, polygon et rectangle sont reconnues, mais ne sont pas conformes pour les auteurs.

Lorsque des zones se chevauchent, le premier area est prioritaire ; placez donc la zone de repli default en dernier. Pour un lien doté de href, fournissez un texte alt descriptif.

Exemples

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

Résultat

Loaded image: 200 × 100
rect | coords: 0,0,100,100 | destination: #left
default | coords: (none) | destination: #rest

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