HTMLVideoElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

L'interface HTMLVideoElement fournit des propriétés et des méthodes spéciales pour manipuler des objets vidéo. Elle hérite également des propriétés et des méthodes de HTMLMediaElement et de HTMLElement.

La liste des formats multimédias pris en charge varie d'un navigateur à l'autre. Vous pouvez fournir votre vidéo dans un format unique que tous les navigateurs pertinents prennent en charge, ou fournir plusieurs sources vidéo dans des formats suffisamment différents couverts par les différents navigateurs que vous ciblez.

Propriétés

Cette interface hérite des propriétés de ses interfaces ancêtres : HTMLMediaElement et HTMLElement.

HTMLVideoElement.height

Une chaîne de caractères DOMString qui reflète la valeur de l'attribut HTML height indiquant la hauteur de la zone d'affichage, en pixels.

HTMLVideoElement.poster

Une chaîne de caractères DOMString qui reflète la valeur de l'attribut poster qui indique une image à afficher tant qu'aucune donnée vidéo n'est disponible.

HTMLVideoElement.videoHeight Lecture seule

Un entier non signé qui indique la hauteur intrinsèque de la ressource, exprimée en pixels CSS, ou 0 tant que le média n'est pas disponible.

HTMLVideoElement.videoWidth Lecture seule

Un entier non signé qui indique la largeur intrinsèque de la ressource, exprimée en pixels CSS, ou 0 tant que le média n'est pas disponible.

HTMLVideoElement.width

Une chaîne de caractères DOMString qui reflète la valeur de l'attribut HTML width indiquant la largeur de la zone d'affichage, en pixels.

Propriétés spécifiques à Gecko

HTMLVideoElement.mozParsedFrames Non-standard Lecture seule

Un entier non signé indiquant le nombre de frames qui ont été analysées (parsed) depuis la ressource média.

HTMLVideoElement.mozDecodedFrames Non-standard Lecture seule

Un entier non signé indiquant le nombre de frames qui ont été décodées en images.

HTMLVideoElement.mozPresentedFrames Non-standard Lecture seule

Un entier non signé indiquant le nombre de frames décodées qui ont été présentées au canal de rendu pour l'affichage.

HTMLVideoElement.mozPaintedFrames Non-standard Lecture seule

Un entier non signé indiquant le nombre de frames présentées et qui ont été affichées à l'écran.

HTMLVideoElement.mozFrameDelay Non-standard Lecture seule

Un double indiquant le retard, exprimé en secondes, pour l'affichage de la dernière frame affichée.

HTMLVideoElement.mozHasAudio Non-standard Lecture seule

Un booléen indiquant s'il y a de l'audio associé à cette vidéo.

Propriétés spécifiques à Microsoft

HTMLVideoElement.msFrameStep() Non-standard

Permet d'avancer ou de reculer la vidéo d'une frame.

HTMLVideoElement.msHorizontalMirror Non-standard

Permet d'indiquer ou de définir si la vidéo est inversée horizontalement dans l'affichage.

HTMLVideoElement.msInsertVideoEffect() Non-standard

Ajoute l'effet vidéo indiqué dans le canal de rendu.

HTMLVideoElement.msIsLayoutOptimalForPlayback Non-standard Lecture seule

Indique si la vidéo peut être affichée plus efficacement.

HTMLVideoElement.msIsStereo3D Non-standard Lecture seule

Un booléen qui détermine si le système considère que la vidéo chargée est en stéréo 3D. La valeur true indique que la source est en stéro 3D.

HTMLVideoElement.msZoom Non-standard

Contrôle si le cadre de la vidéo est réduit pour s'inscrire dans la zone d'affichage de la vidéo (autrement dit : si la vidéo est zoomée/tronquée pour s'inscrire dans la zone correspondante).

Méthodes

Hérite des méthodes de son parent HTMLMediaElement et de son ancêtre HTMLElement.

HTMLVideoElement.getVideoPlaybackQuality() Expérimental

Cette méthode renvoie un objet VideoPlaybackQuality contenant les métriques/statistiques sur la lecture actuelle avec des informations comme le nombre d'images sautées ou corrompues ainsi que le nombre total d'images.

Évènements

Hérite des méthodes de son parent HTMLMediaElement et de son ancêtre HTMLElement. Pour écouter ces évènements, on utilisera addEventListener() ou on affectera un gestionnaire d'évènement avec la propriété on<NomEvenement> (ex. onclick) de l'interface.

Spécifications

Specification
HTML Standard
# htmlvideoelement

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi