HTMLImageElement: longDesc-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

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

Wert

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

Beispielsweise, wenn das Bild ein PNG eines Flussdiagramms ist. Die longDesc-Eigenschaft könnte verwendet werden, um eine Erklärung des dargestellten Kontrollflusses nur in Textform bereitzustellen. Dies kann von Lesern sowohl als Erklärung als auch als Ersatz für sehbehinderte Nutzer verwendet werden.

Nutzungshinweise

Diese Eigenschaft ist veraltet und sollte nicht mehr verwendet werden. Anstatt longDesc zu verwenden, um einen Link zu einer detaillierten Beschreibung eines Bildes bereitzustellen, sollte das Bild mit einem Link unter Verwendung des <a>-Elements umschlossen werden.

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 anzuzeigen, dass der Benutzer in der Lage sein sollte, eine detaillierte Beschreibung des Bildes taco-tuesday.jpg in der HTML-Datei image-descriptions/taco-tuesday.html abzurufen.

Dies kann leicht in modernes HTML konvertiert werden:

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

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

Spezifikationen

Specification
HTML Standard
# dom-img-longdesc

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch