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 des HTMLImageElement spiegelt den Wert des HTML-usemap-Attributs wider, welches eine Zeichenfolge ist, die den Namen der clientseitigen Image-Map angibt, die auf das Bild angewendet werden soll.

Wert

Eine Zeichenfolge, die die seitenlokale URL bereitstellt (das heißt, eine URL, die mit dem Rautezeichen oder Hash-Symbol, #, beginnt) des <map>-Elements, das die Image-Map definiert, die auf das Bild angewendet werden soll.

Sie können mehr über clientseitige Image-Maps in unserem Lernartikel Eine Treffermarkierung über ein Bild legen erfahren.

Verwendungshinweise

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>-name-Attributs sein, dem ein Raute- oder Hash-Symbol voransteht.

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>

Für die Image-Map namens mainmenu-map sollte das Bild, das sie verwendet, etwa wie folgt aussehen:

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

Für zusätzliche Beispiele (einschließlich interaktiver) sehen Sie sich die Artikel über die <map>- und <area>-Elemente an sowie den Leitfaden zur Verwendung von Image-Maps.

Beispiele

Probieren Sie es aus

Spezifikationen

Specification
HTML Standard
# dom-img-usemap

Browser-Kompatibilität

BCD tables only load in the browser