Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

shape — kształt obszaru mapy obrazu

Atrybut shape elementu area wybiera geometrię obszaru mapy obrazu. Wartości rect, circle i poly wymagają współrzędnych coords; default obejmuje cały obraz.

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

Składnia

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

shape jest atrybutem wyliczeniowym elementu area wewnątrz map. Obraz łączy się z mapą przez usemap="#nazwa", wskazujące jej name. Kształt określa obszar interakcji, nie rysuje widocznej figury.

Dla rect podaj w coords dokładnie cztery liczby całkowite: x1,y1,x2,y2, gdzie x1 < x2 i y1 < y2. Dla circle podaj x,y,r: środek i nieujemny promień; promień równy zero daje pusty obszar. Dla poly podaj parzystą liczbę liczb całkowitych, co najmniej sześć, opisujących kolejne wierzchołki. Współrzędne są w pikselach CSS od lewego górnego rogu wyświetlanego obrazu; zmiana jego rozmiaru nie skaluje ich automatycznie.

default obejmuje cały obraz i wymaga pominięcia coords. Brak shape lub nieprawidłowa wartość oznacza rect, nie default. Historyczne wartości circ, polygon i rectangle są rozpoznawane, ale niezgodne ze standardem dla autorów.

Przy nakładaniu obszarów pierwszeństwo ma wcześniejszy area; dlatego obszar default umieszczaj na końcu jako uzupełnienie. Dla odsyłacza z href podaj opisowe alt.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła