HTMLVideoElement
Baseline
Widely available
*
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
Implémentée par l'élément HTML <video>, l'interface HTMLVideoElement fournit des propriétés et méthodes particulières pour manipuler les objets vidéo. Elle hérite également des propriétés et méthodes de HTMLMediaElement et HTMLElement.
La liste des formats médias pris en charge varie d'un navigateur à l'autre. Vous devez soit fournir votre vidéo dans un format unique pris en charge par tous les navigateurs concernés, soit fournir plusieurs sources vidéo dans suffisamment de formats différents pour couvrir tous les navigateurs que vous souhaitez prendre en charge.
Propriétés d'instance
Hérite des propriétés de son interface parente, HTMLMediaElement et de HTMLElement.
HTMLVideoElement.disablePictureInPicture-
Indique si l'agent utilisateur doit suggérer le mode image dans l'image aux utilisateur·ice·s ou non.
HTMLVideoElement.height-
Une chaîne de caractères qui reflète l'attribut HTML
height, qui indique la hauteur de la zone d'affichage, en pixels CSS. HTMLVideoElement.poster-
Une chaîne de caractères qui reflète l'attribut HTML
poster, qui indique une image à afficher tant qu'aucune donnée vidéo n'est disponible. HTMLVideoElement.videoHeightLecture seule-
Retourne une valeur entière non signée indiquant la hauteur intrinsèque de la ressource en pixels CSS, ou 0 si aucun média n'est encore disponible.
HTMLVideoElement.videoWidthLecture seule-
Retourne une valeur entière non signée indiquant la largeur intrinsèque de la ressource en pixels CSS, ou 0 si aucun média n'est encore disponible.
HTMLVideoElement.width-
Une chaîne de caractères qui reflète l'attribut HTML
width, qui indique la largeur de la zone d'affichage, en pixels CSS.
Propriétés spécifiques à Firefox
HTMLVideoElement.mozParsedFramesLecture seule Non standard Obsolète-
Retourne un
unsigned longindiquant le nombre d'images vidéo qui ont été analysées depuis la ressource média. HTMLVideoElement.mozDecodedFramesLecture seule Non standard Obsolète-
Retourne un
unsigned longindiquant le nombre d'images vidéo analysées qui ont été décodées en images. HTMLVideoElement.mozPresentedFramesLecture seule Non standard Obsolète-
Retourne un
unsigned longindiquant le nombre d'images décodées qui ont été présentées au pipeline de rendu pour affichage. HTMLVideoElement.mozPaintedFramesLecture seule Non standard Obsolète-
Retourne un
unsigned longindiquant le nombre d'images présentées qui ont été affichées à l'écran. HTMLVideoElement.mozFrameDelayLecture seule Non standard Obsolète-
Retourne un
doubleindiquant le temps de retard, en secondes, de la dernière image vidéo affichée. HTMLVideoElement.mozHasAudioLecture seule Non standard Obsolète-
Retourne un booléen indiquant s'il y a de l'audio associé à la vidéo.
Méthodes d'instances
Hérite des méthodes de son interface parente, HTMLMediaElement et de HTMLElement.
HTMLVideoElement.cancelVideoFrameCallback()-
Annule une fonction de rappel de trame vidéo précédemment enregistrée (voir
requestVideoFrameCallback()). HTMLVideoElement.getVideoPlaybackQuality()-
Retourne un objet
VideoPlaybackQualityqui contient les métriques de lecture actuelles. Ces informations incluent, par exemple, le nombre d'images perdues ou corrompues ainsi que le nombre total d'images. HTMLVideoElement.requestPictureInPicture()-
Demande à l'agent utilisateur de passer la vidéo en mode image dans l'image.
HTMLVideoElement.requestVideoFrameCallback()-
Enregistre une fonction de rappel qui s'exécute lorsqu'une nouvelle trame vidéo est envoyée au compositeur. Cela permet aux développeur·euse·s d'effectuer des opérations efficaces sur chaque trame vidéo.
Évènements
Hérite des évènements de son interface parente, HTMLMediaElement et de HTMLElement.
Écoutez ces évènements en utilisant addEventListener() ou en assignant un gestionnaire d'évènement à la propriété oneventname de cette interface.
enterpictureinpicture-
Déclenché lorsque le
HTMLVideoElementpasse avec succès en mode image dans l'image. leavepictureinpicture-
Déclenché lorsque le
HTMLVideoElementquitte avec succès le mode image dans l'image. resize-
Déclenché lorsque l'une ou les deux propriétés
videoWidthetvideoHeightviennent d'être mises à jour.
Spécifications
| Specification |
|---|
| HTML> # htmlvideoelement> |
Compatibilité des navigateurs
Voir aussi
- L'élément HTML qui implémente cette interface :
<video>. - Les formats médias pris en charge