База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

ismap — изображенска карта от страна на сървъра

Булевият атрибут `ismap` на `img` обозначава изображенска карта от страна на сървъра. Изображението трябва да е в елемент `a` с `href`. При щракване браузърът добавя координатите към URL адреса на връзката; тълкуването им е отговорност на сървъра.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

ismap е булев атрибут на img. Може да се зададе само ако изображението има предшественик елемент a с атрибут href. Наличието му активира механизма за изображенска карта от страна на сървъра; то не задава области или техните цели в документа.

При щракване върху изображението браузърът добавя суфикса ?x,y към URL адреса на връзката. Координатите се изразяват като десетични цели числа и се измерват в CSS пиксели от горния ляв ъгъл на изображението, а не в пикселите на изходния файл. Отрицателните стойности се ограничават до нула. При недоверено събитие, например задействано от скрипт, алгоритъмът използва 0,0.

Валидните форми са ismap, ismap="" и ismap="ismap". Записът ismap="false" е невалиден и не изключва механизма: атрибутът все още е налице. За да го изключите, премахнете атрибута.

За разлика от usemap, който препраща към карта от страна на клиента, ismap изпраща координати към сървъра. Сървърът трябва да ги интерпретира и да избере отговор. Осигурете и текстови връзки към същите функции, така че изборът да не изисква прецизно посочване върху изображението.

В примера връзката сочи към #result, а обработчикът на събитието при щракване извиква event.preventDefault(), за да предотврати навигацията. Примерът показва как свойството isMap в DOM отразява атрибута ismap: първоначално стойността му е true, задаването на false премахва атрибута, а възстановяването на началната стойност го добавя отново. При щракване не се изпраща заявка с координати.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници