Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLImageElement : propriété longDesc

Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

La propriété longDesc (obsolète) de l'interface HTMLImageElement spécifie l'URL d'un fichier texte ou HTML contenant une description détaillée de l'image. Cela peut être utilisé pour fournir des informations supplémentaires facultatives au-delà de la brève description fournie dans l'attribut title.

Valeur

Une chaîne de caractères qui peut être soit une chaîne vide (indiquant qu'aucune description longue n'est disponible), soit l'URL d'un fichier contenant une description longue du contenu de l'image.

Par exemple, si l'image est un PNG représentant un organigramme, la propriété longDesc peut être utilisée pour fournir une explication du déroulement représenté par le schéma, uniquement en texte. Cela peut servir d'explication pour les lecteur·ice·s, mais aussi de substitut pour les utilisateur·ice·s malvoyant·e·s.

Notes d'utilisation

Cette propriété est obsolète et ne doit plus être utilisée. Au lieu d'utiliser longDesc pour fournir un lien vers une description détaillée d'une image, encapsulez l'image dans un lien à l'aide de l'élément HTML <a>.

Considérez l'exemple HTML suivant :

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

Ici, longDesc est utilisé pour indiquer que l'utilisateur·ice doit pouvoir accéder à une description détaillée de l'image taco-tuesday.jpg dans le fichier HTML image-descriptions/taco-tuesday.html.

Ceci peut être facilement converti en HTML moderne :

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

Ainsi, l'image devient un lien vers le fichier HTML décrivant l'image plus en détail.

Spécifications

Specification
HTML
# dom-img-longdesc

Compatibilité des navigateurs

Voir aussi