HTMLVideoElement
================

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` (en-US)

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` (en-US) 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` (en-US) 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` (en-US)

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()` (en-US) 
Non-standard

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

`HTMLVideoElement.msHorizontalMirror` (en-US) 
Non-standard

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

`HTMLVideoElement.msInsertVideoEffect()` (en-US) 
Non-standard

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

`HTMLVideoElement.msIsLayoutOptimalForPlayback` (en-US) 
Non-standard
Lecture seule 

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

`HTMLVideoElement.msIsStereo3D` (en-US) 
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` (en-US) 
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()` (en-US) 
Expérimental

Cette méthode renvoie un objet `VideoPlaybackQuality` (en-US) 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 with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'élément HTML qui implémente cette interface `<video>`.
* Les formats médias pris en charge