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 auf der Schnittstelle HTMLImageElement spezifiziert die URL einer Text- oder HTML-Datei, die eine ausführliche Beschreibung des Bildes enthält. Diese 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 enthält, die eine ausführliche Beschreibung der Inhalte des Bildes bereitstellt.

Zum Beispiel, wenn das Bild ein PNG eines Flussdiagramms ist. Die longDesc-Eigenschaft könnte verwendet werden, um eine Erklärung des dargestellten Kontrollflusses ausschließlich in Textform bereitzustellen. Dies kann sowohl als Erklärung für Leser als auch als Ersatz für sehbehinderte Benutzer dienen.

Anwendungshinweise

Diese Eigenschaft ist veraltet und sollte nicht mehr verwendet werden. Statt longDesc zu verwenden, um einen Link zu einer detaillierten Beschreibung eines Bildes bereitzustellen, sollten Sie das Bild in einen Link mithilfe des <a>-Elements einbetten.

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 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 zur HTML-Datei, die das Bild ausführlicher beschreibt.

Spezifikationen

Specification
HTML
# dom-img-longdesc

Browser-Kompatibilität

Siehe auch