HTMLImageElement: longDesc-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die veraltete Eigenschaft longDesc der HTMLImageElement-Schnittstelle gibt die URL einer Text- oder HTML-Datei an, die eine ausführliche Beschreibung des Bildes enthält. Dies kann verwendet werden, um optional zusätzliche Details über die kurze Beschreibung hinaus bereitzustellen, die im title-Attribut angegeben ist.

Wert

Ein String, der entweder ein leerer String sein kann (was bedeutet, dass keine ausführliche Beschreibung verfügbar ist) oder die URL einer Datei, die eine ausführliche Beschreibung des Bildinhalts enthält.

Zum Beispiel, wenn das Bild ein PNG eines Flussdiagramms ist. Die longDesc-Eigenschaft könnte verwendet werden, um eine Erklärung des Kontrollflusses, der durch das Diagramm dargestellt wird, nur mithilfe von Text bereitzustellen. Dies kann von Lesern sowohl als Erklärung als auch als Ersatz für sehbehinderte Nutzer verwendet werden.

Verwendungshinweise

Diese Eigenschaft ist veraltet und sollte nicht mehr verwendet werden. Anstatt longDesc zu verwenden, um einen Link zu einer ausführlichen Beschreibung eines Bildes bereitzustellen, sollten Sie das Bild in einen Link innerhalb des <a>-Elements kapseln.

Betrachten Sie das folgende ältere HTML:

html
<img
  src="taco-tuesday.jpg"
  alt="Taco Tuesday"
  longdesc="image-descriptions/taco-tuesday.html" />

Hier wird longDesc verwendet, um anzugeben, dass der Benutzer in der Lage sein sollte, eine ausführliche Beschreibung des Bildes taco-tuesday.jpg in der HTML-Datei image-descriptions/taco-tuesday.html zu erreichen.

Dies kann einfach in modernes HTML umgewandelt werden:

html
<a href="image-descriptions/taco-tuesday.html">
  <img src="taco-tuesday.jpg" alt="Taco Tuesday" />
</a>

Damit ist das Bild ein Link zur HTML-Datei, die das Bild ausführlicher beschreibt.

Spezifikationen

Specification
HTML
# dom-img-longdesc

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
longDesc
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.

Siehe auch