Code court Vidéo

La fonction vidéo vous permet d’embarquer des fichiers vidéo et de les lire à l’aide d’un simple code court. Cette fonctionnalité a été ajoutée à partir de WordPress 3.6 et elle est utilisée ainsi :

[video]

Vous pouvez également saisir l’URL du média sur une nouvelle ligne et elle sera automatiquement transformée en contenu embarqué :

Mon contenu vidéo sympa
https://my.movies.com/video/film/sympa.mp4
Plus de contenu sympa

Cas d’usage

J’ai une ancienne publication à laquelle est attaché un fichier vidéo se trouvant dans la médiathèque et je souhaite utiliser le code court pour afficher cette vidéo sur mon site :

[video]

J’ai l’URL d’un fichier MP4 présent dans la médiathèque ou externe au site et je veux le rendre lisible sur mon site :

[video src="video-source.mp4"]

J’ai l’URL d’un fichier vidéo dans les différents formats de fichier supportés par HTML5 :

[video mp4="source.mp4" ogv="source.ogv" webm="source.webm"]

Options

Les options suivantes sont prises en charge :

src

(chaîne (en anglais)) (optionnel) – Le fichier source de votre vidéo. Si la source n’est pas incluse, le premier fichier vidéo joint à la publication sera utilisé. Vous pouvez utiliser les options suivantes pour définir des formats de fichier supplémentaires destinés à fournir une solution de secours lorsque le format principal n’est pas reconnu :

« mp4 », « m4v », « webm », « ogv », « wmv », « flv ».

Par défaut : le premier fichier vidéo joint à la publication.

poster

(chaîne (en anglais)) (optionnel) – Permet de définir l’image par défaut avant que la vidéo ne démarre.

https://www.exemple.org/wp-content/uploads/image.jpg

Par défaut : aucune.

loop

(chaîne (en anglais)) (optionnel) – Permet la lecture en boucle de la vidéo.

« off » – La lecture ne boucle pas.

« on » – La lecture se fait en boucle sans discontinuer.

Par défaut : « off ».

autoplay

(chaîne (en anglais)) (optionnel) – Démarre automatiquement la lecture de la vidéo dès que le fichier est chargé.

« off » – Ne démarre pas automatiquement.

« on » – Démarre la lecture dès que le fichier est disponible.

Par défaut : « off ».

preload

(chaîne (en anglais)) (optionnel) – Spécifie si la vidéo doit être chargée durant le chargement de la page, et comment.

« metadata » – Seules les métadonnées doivent être chargées en même temps que la page.

« none » – La vidéo ne doit pas être chargée lors du chargement de la page.

« auto » – La vidéo doit être entièrement chargée lorsque la page se charge.

Par défaut : « metadata ».

width

(entier (en anglais)) (obligatoire) – Définit la largeur de la vidéo. La valeur est automatiquement détectée lors du téléversement dans la médiathèque.

Par défaut : largeur du média.

height

(entier (en anglais)) (obligatoire) – Définit la hauteur de la vidéo. La valeur est automatiquement détectée lors du téléversement dans la médiathèque.

Par défaut : hauteur du média.

Exemple utilisant toutes les options :

[video mp4="video.mp4" ogv="video.ogv" webm="video.webm" poster="image.jpg" loop="on" autoplay="on" preload="metadata" width="640" height="360"]

Articles en relation

Codes courts WordPress : audiocaption (en anglais)embed (en anglais)gallery (en anglais)playlist (en anglais)

Traduit par Loïc Antignac
Relu par Jb Audras & Jenny Dupuy
Dernière mise à jour le 18 octobre 2021

Contribuer à la documentation en français de WordPress