HTMLImageElement: longDesc プロパティ

非推奨;: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

longDesc は HTMLImageElement インターフェイスの非推奨のプロパティで、この画像の長い説明のテキストまたは HTML ファイルの URL を指定します。これは、title 属性で提供される短い説明の他に、オプションで追加された詳細を提供するために使用することができます。

値

空文字列（長い説明文がないことを示す）または、画像の内容の長い形式の説明文を含むファイルの URL のいずれかを指定します。

例えば、画像がフローチャートの PNG であった場合、 longDesc プロパティは、チャートで表現された制御の流れについて、テキストのみの説明を提供するために使用することができます。これは、読者が使用する説明としてだけでなく、視覚障碍者のための代替表現として使用することもできます。

使用上の注意

このプロパティは非推奨であり、今後使用するべきではありません。画像の詳細な説明へのリンクを提供するには、 longDesc を使用する代わりに、 <a> 要素を使用してリンク内に画像をカプセル化するようにしてください。

以下の古い HTML があったとします。

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

ここでは longDesc を使って、画像 taco-tuesday.jpg の詳細な説明を HTML ファイル image-descriptions/taco-tuesday.html で参照できるようにすることを指定しています。

これは簡単に現在の HTML に変換することができます。

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

それに伴い、画像はより詳細に記述された HTML ファイルへのリンクとなります。

仕様書

Specification
HTML
# dom-img-longdesc

ブラウザーの互換性

BCD tables only load in the browser

関連情報