Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

ismap — mapa obrazu obsługiwana przez serwer

Atrybut logiczny `ismap` na elemencie `img` oznacza mapę obrazu obsługiwaną przez serwer. Obraz musi znajdować się wewnątrz elementu `a` z `href`. Przy kliknięciu przeglądarka dopisuje współrzędne do adresu odnośnika; ich interpretacja należy do serwera.

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

Składnia

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

ismap jest atrybutem logicznym elementu img. Wolno go podać tylko wtedy, gdy obraz ma przodka a z atrybutem href. Jego obecność włącza mechanizm mapy obrazu obsługiwanej przez serwer; nie definiuje obszarów ani ich adresów w dokumencie.

Po kliknięciu obrazu przeglądarka dopisuje do adresu odnośnika sufiks ?x,y. Współrzędne są zapisywane jako dziesiętne liczby całkowite i mierzone w pikselach CSS od lewego górnego rogu obrazu, a nie w pikselach pliku źródłowego. Ujemne wartości są zastępowane przez zero. Dla niezaufanego zdarzenia, na przykład wywołanego skryptem, algorytm używa 0,0.

Poprawne zapisy to ismap, ismap="" i ismap="ismap". Zapis ismap="false" jest niepoprawny i nie wyłącza mechanizmu: atrybut nadal jest obecny. Aby go wyłączyć, usuń atrybut.

W odróżnieniu od usemap, które wskazuje mapę po stronie klienta, ismap przekazuje współrzędne do serwera. Serwer musi je zinterpretować i wybrać odpowiedź. Zapewnij także odnośniki tekstowe do tych samych funkcji, aby wybór nie wymagał precyzyjnego wskazywania obrazu.

W przykładzie odnośnik prowadzi do #result, a procedura obsługi kliknięcia wywołuje event.preventDefault(), aby zapobiec nawigacji. Przykład pokazuje, jak właściwość DOM isMap odzwierciedla atrybut ismap: początkowo ma wartość true, ustawienie jej na false usuwa atrybut, a przywrócenie początkowej wartości ponownie go dodaje. Kliknięcie nie wysyła żądania ze współrzędnymi.

Przykłady

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

Wynik

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

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

Źródła