<video>

Un lecteur vidéo intégré directement à la page.

Affichage
inline (élément remplacé)
Balise fermante
Obligatoire
Contenu autorisé
Des éléments <source> et <track>, suivis d’un contenu de remplacement
Sur cette page

Exemple

#
HTML
<video controls width="300" height="200" preload="none" poster="/collections/covers/od-czego-zaczac-nauke-programowania.webp">
  <source src="/media/lekcja-1.webm" type="video/webm">
  <source src="/media/lekcja-1.mp4" type="video/mp4">
  <track kind="captions" src="/media/lekcja-1-pl.vtt" srclang="pl" label="Polonais" default>
  <a href="/media/lekcja-1.mp4">Télécharger la leçon en MP4</a>
</video>
Aperçu

Le fichier vidéo et les sous-titres sont omis de l’aperçu, c’est pourquoi vous ne voyez que l’affiche et les commandes.

Définition et utilisation

#

L’élément <video> affiche une vidéo à partir d’un fichier, sans aucun plugin externe. Vous indiquez la source dans l’attribut src ou dans plusieurs éléments <source> avec différents formats, et vous ajoutez des sous-titres avec des éléments <track>.

L’attribut controls affiche la barre de lecture intégrée, et poster définit une image visible avant le début de la vidéo. Il est aussi utile d’indiquer width et height, pour que le navigateur réserve la place du lecteur avant le chargement de la vidéo.

La lecture automatique ne fonctionne généralement qu’en mode muet, c’est pourquoi les courtes animations d’arrière-plan s’écrivent autoplay muted loop playsinline. Vous ne pouvez pas intégrer avec <video> les vidéos de services comme YouTube. Pour celles-ci, utilisez un <iframe> avec le code fourni par le service.

Syntaxe

#
Syntaxe
<video src="video.mp4" controls width="…" height="…"></video>

Attributs

#
  • src

    URL

    L’adresse du fichier vidéo. Quand vous voulez proposer plusieurs formats, utilisez des éléments <source> à l’intérieur de <video> au lieu de src.
  • controls

    attribut booléen

    Affiche les commandes intégrées : lecture, ligne de temps, volume, plein écran. Sans elles, l’utilisateur n’a aucun moyen de contrôler la vidéo, à moins que vous ne construisiez vos propres boutons.
  • poster

    URL de l’image

    Une image affichée avant le démarrage de la vidéo. Sans elle, le lecteur affiche la première image de la vidéo, ou un rectangle vide tant que cette image n’est pas chargée.
  • width / height

    nombre de pixels

    Les dimensions du lecteur. La vidéo est ajustée à cette zone en conservant ses proportions, et avec des proportions différentes, des bandes vides apparaissent.
  • autoplay

    attribut booléen

    Lance la vidéo juste après le chargement. Les navigateurs ne l’autorisent généralement que si la vidéo est coupée avec l’attribut muted.
  • muted

    attribut booléen

    Lance la vidéo sans le son. En pratique indispensable avec autoplay.
  • loop

    attribut booléen

    Une fois arrivée à la fin, la vidéo recommence depuis le début.
  • playsinline

    attribut booléen

    Sur iPhone, lit la vidéo sur place dans la page au lieu de passer automatiquement en plein écran. Important pour les courtes animations d’arrière-plan.
  • preload

    none | metadata | auto

    La quantité de données à télécharger à l’avance. Sur une page avec beaucoup de vidéos, définissez none ou metadata pour ne pas gaspiller de bande passante.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

controls

attribut booléen

Affiche les commandes intégrées : lecture, ligne de temps, volume, plein écran. Sans elles, l’utilisateur n’a aucun moyen de contrôler la vidéo, à moins que vous ne construisiez vos propres boutons.

HTML
<video src="/media/lekcja-2.mp4" controls width="240" height="160" preload="none" poster="/collections/covers/programowanie-dla-dzieci.webp"></video>
Aperçu

Le fichier vidéo est omis de l’aperçu.

poster

URL de l’image

Une image affichée avant le démarrage de la vidéo. Sans elle, le lecteur affiche la première image de la vidéo, ou un rectangle vide tant que cette image n’est pas chargée.

HTML
<video src="/media/gra-w-kodowanie.mp4" controls width="240" height="160" preload="none" poster="/collections/covers/gry-do-nauki-programowania.webp"></video>
Aperçu

Le fichier vidéo est omis de l’aperçu, seule l’affiche est visible.

Plus d’exemples

#
Une courte animation d’arrière-plan
HTML
<video autoplay muted loop playsinline width="300" height="200" poster="/collections/covers/vibe-coding.webp">
  <source src="/media/tlo-animacja.webm" type="video/webm">
  <source src="/media/tlo-animacja.mp4" type="video/mp4">
</video>
Aperçu

Le fichier vidéo est omis de l’aperçu, c’est pourquoi seule l’affiche est visible. Sur une vraie page, l’animation tourne en boucle sans son.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ajoutez des sous-titres avec <track kind="captions">. Beaucoup de personnes regardent les vidéos sans le son, et pour les personnes sourdes, les sous-titres sont le seul moyen de suivre.
  • Ne téléversez pas sur le serveur d’énormes fichiers sortis directement de la caméra. Compressez la vidéo et envisagez un format plus léger, par exemple WebM, avec MP4 en version de secours.
  • Pour les vidéos YouTube ou Vimeo, utilisez un <iframe> avec le code d’intégration du service, et non <video>.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.