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

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.

EventTarget Node Element HTMLElement HTMLMediaElement HTMLVideoElement

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.videoHeight Lecture 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.videoWidth Lecture 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.mozParsedFrames Lecture seule Non standard Obsolète

Retourne un unsigned long indiquant le nombre d'images vidéo qui ont été analysées depuis la ressource média.

HTMLVideoElement.mozDecodedFrames Lecture seule Non standard Obsolète

Retourne un unsigned long indiquant le nombre d'images vidéo analysées qui ont été décodées en images.

HTMLVideoElement.mozPresentedFrames Lecture seule Non standard Obsolète

Retourne un unsigned long indiquant le nombre d'images décodées qui ont été présentées au pipeline de rendu pour affichage.

HTMLVideoElement.mozPaintedFrames Lecture seule Non standard Obsolète

Retourne un unsigned long indiquant le nombre d'images présentées qui ont été affichées à l'écran.

HTMLVideoElement.mozFrameDelay Lecture seule Non standard Obsolète

Retourne un double indiquant le temps de retard, en secondes, de la dernière image vidéo affichée.

HTMLVideoElement.mozHasAudio Lecture 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 VideoPlaybackQuality qui 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 HTMLVideoElement passe avec succès en mode image dans l'image.

leavepictureinpicture

Déclenché lorsque le HTMLVideoElement quitte avec succès le mode image dans l'image.

resize

Déclenché lorsque l'une ou les deux propriétés videoWidth et videoHeight viennent d'être mises à jour.

Spécifications

Specification
HTML
# htmlvideoelement

Compatibilité des navigateurs

Voir aussi