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 HTMLheight
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'attributposter
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 HTMLwidth
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
- L'élément HTML qui implémente cette interface
<video>
. - Les formats médias pris en charge