HTMLImageElement : propriété longDesc
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.>
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. Elle reflète l'attribut de contenu longdesc de l'élément <img>.
Cet attribut est considéré comme obsolète dans la spécification HTML (angl.). Son avenir est incertain ; les auteur·ice·s doivent utiliser une alternative WAI-ARIA telle que aria-describedby ou aria-details. Vous pouvez également encapsuler l'image dans un lien à l'aide de l'élément HTML <a>.
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.
Exemples
Considérez l'exemple HTML suivant :
<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 :
<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
| Spécification |
|---|
| HTML> # dom-img-longdesc> |
Compatibilité des navigateurs
Voir aussi
- L'attribut ARIA
aria-details