HTMLSourceElement

L'interface HTMLSourceElement fournit des propriétés spécifiques (en plus de l'interface HTMLElement qu'elle hérite également) pour manipuler les éléments HTML <source>.

Propriétés d'instance

Hérite des propriétés de son parent, HTMLElement.

HTMLSourceElement.height

Un nombre qui reflète l'attribut HTML height, indiquant la hauteur de la ressource image en pixels CSS. Cette propriété n'a de sens que si le parent de l'élément HTML <source> courant est un élément HTML <picture>.

HTMLSourceElement.media

Une chaîne de caractères reflétant l'attribut HTML media, contenant le type prévu de la ressource média.

HTMLSourceElement.sizes

Une chaîne de caractères représentant les tailles d'image entre les points de rupture.

HTMLSourceElement.src

Une chaîne de caractères reflétant l'attribut HTML src, contenant l'URL de la ressource média. La propriété HTMLSourceElement.src n'a de sens que lorsque l'élément HTML <source> associé est imbriqué dans un élément média qui est un élément HTML <video> ou HTML <audio>. Elle n'a pas de sens et est ignorée lorsqu'elle est imbriquée dans un élément HTML <picture>.

Note : Si la propriété src est modifiée (ainsi que celles des autres éléments au même niveau), la méthode load du parent HTMLMediaElement doit être appelée une fois terminé, car les éléments <source> ne sont pas rescannés automatiquement.

HTMLSourceElement.srcset

Une chaîne de caractères reflétant l'attribut HTML srcset, contenant une liste d'images candidates, séparées par une virgule (',', U+002C VIRGULE). Une image candidate est une URL suivie d'un 'w' avec la largeur de l'image, ou d'un 'x' suivi de la densité de pixels.

HTMLSourceElement.type

Une chaîne de caractères reflétant l'attribut HTML type, contenant le type de la ressource média.

HTMLSourceElement.width

Un nombre qui reflète l'attribut HTML width, indiquant la largeur de la ressource image en pixels CSS. Cette propriété n'a de sens que si le parent de l'élément HTML <source> courant est un élément HTML <picture>.

Méthodes d'instance

Aucune méthode spécifique ; hérite des méthodes de son parent, HTMLElement.

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML qui implémente cette interface : <source>.
• Les API DOM HTML des éléments pouvant contenir un élément <source> : HTMLVideoElement, HTMLAudioElement, HTMLPictureElement.