HTMLImageElement: useMap-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die useMap-Eigenschaft auf der HTMLImageElement-Schnittstelle spiegelt den Wert des HTML usemap-Attributs wider, welcher eine Zeichenfolge ist, die den Namen der clientseitigen Imagemap angibt, die auf das Bild angewendet werden soll.

Wert

Eine Zeichenfolge, die die pagelokale URL bereitstellt (das heißt, eine URL, die mit dem Hash- oder Pfund-Symbol # beginnt) des <map>-Elements, das die Imagemap definiert, die auf das Bild anzuwenden ist.

Sie können mehr über clientseitige Imagemaps in unserem Lernartikel Fügen Sie eine Trefferkarte über ein Bild hinzu erfahren.

Nutzungshinweise

Der Zeichenfolgenwert von useMap muss ein gültiger Anker für ein <map>-Element sein. Mit anderen Worten, diese Zeichenfolge sollte der Wert des entsprechenden <map>-Attributs name mit einem davor gestellten Pfund- oder Hash-Symbol sein.

Betrachten Sie ein <map>, das wie folgt aussieht:

html
<map name="mainmenu-map">
  <area
    shape="circle"
    coords="25, 25, 75"
    href="/index.html"
    alt="Return to home page" />
  <area shape="rect" coords="25, 25, 100, 150" href="/index.html" alt="Shop" />
</map>

Angenommen, die Imagemap heißt mainmenu-map, sollte das Bild, das sie verwendet, ungefähr so aussehen:

html
<img src="menubox.png" usemap="#mainmenu-map" />

Für zusätzliche Beispiele (einschließlich interaktiver), siehe die Artikel über die <map>- und <area>-Elemente sowie den Leitfaden zur Verwendung von Imagemaps.

Beispiele

Probieren Sie es aus

Spezifikationen

Specification
HTML Standard
# dom-img-usemap

Browser-Kompatibilität

BCD tables only load in the browser