KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

shape — geometrie van een afbeeldingskaartgebied

Het attribuut shape van area bepaalt de geometrie van een gebied op een afbeeldingskaart. De waarden rect, circle en poly vereisen coords; default omvat de hele afbeelding.

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

Syntax

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

shape is een enumeratieattribuut van een area-element binnen map. Een afbeelding wordt aan de kaart gekoppeld met usemap="#name", dat verwijst naar de name ervan. De vorm bepaalt een interactief gebied; er wordt geen zichtbare figuur getekend.

Geef voor rect precies vier gehele getallen op in coords: x1,y1,x2,y2, waarbij x1 < x2 en y1 < y2. Geef voor circle x,y,r op: het middelpunt en een niet-negatieve straal; een straal van nul levert een leeg gebied op. Geef voor poly een even aantal gehele getallen op, minstens zes, die opeenvolgende hoekpunten beschrijven. De coördinaten zijn CSS-pixels vanaf de linkerbovenhoek van de weergegeven afbeelding; het formaat van de afbeelding wijzigen schaalt ze niet automatisch mee.

default omvat de hele afbeelding en vereist dat coords wordt weggelaten. Als shape ontbreekt of een ongeldige waarde heeft, geldt rect, niet default. De historische waarden circ, polygon en rectangle worden herkend, maar zijn niet conform voor auteurs.

Bij overlappende gebieden krijgt de eerdere area voorrang; plaats een terugvalgebied met default daarom als laatste. Geef voor een link met href beschrijvende alt-tekst op.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen