2024-06-28 03:11:54
Cette extension ajoute un nouveau nœud d’intégration YouTube à l’éditeur.
Installer
npm install @tiptap/extension-youtube
Paramètres
en ligne
Contrôle si le nœud doit être traité en ligne ou en tant que bloc.
Par défaut : faux
Youtube.configure({ en ligne : false, })
largeur
Contrôle la largeur par défaut des vidéos ajoutées
Par défaut : 640
Youtube.configure({ largeur : 480, })
hauteur
Contrôle la hauteur par défaut des vidéos ajoutées
Par défaut : 480
Youtube.configure({ hauteur: 320, })
contrôles
Active ou désactive les commandes vidéo YouTube
Par défaut : vrai
Youtube.configure({ contrôles : false, })
pas de cookie
Active le mode nocookie pour les intégrations YouTube
Par défaut : faux
Youtube.configure({ nocookie : true, })
autoriserPlein écran
Permet de lire l’iframe en plein écran
Par défaut : vrai
Youtube.configure({ allowFullscreen: false, })
lecture automatique
Permet à l’iframe de démarrer la lecture après le chargement du lecteur
Par défaut : faux
Youtube.configure({ lecture automatique : true, })
ccLangue
Spécifie la langue par défaut que le lecteur utilisera pour afficher les sous-titres. Définissez la valeur du paramètre sur un code de langue à deux lettres ISO 639-1. Par exemple, si vous le définissez sur es, les légendes seront en espagnol.
Par défaut : non défini
Youtube.configure({ ccLanguage: ‘es’, })
Politique de chargement cc
La définition de la valeur de ce paramètre sur true entraîne l’affichage des sous-titres par défaut, même si l’utilisateur a désactivé les sous-titres.
Par défaut : faux
Youtube.configure({ ccLoadPolicy : true, })
désactiver les contrôles KB
Désactive les commandes du clavier pour le lecteur iframe
Par défaut : faux
Youtube.configure({disableKBcontrols : true, })
activerIFrameApi
Permet au lecteur d’être contrôlé via les appels API IFrame Player
Par défaut : faux
Youtube.configure({enableIFrameApi : true, })
origine
Ce paramètre fournit une mesure de sécurité supplémentaire pour l’API IFrame et n’est pris en charge que pour les intégrations IFrame. Si vous utilisez l’API IFrame, ce qui signifie que vous définissez la valeur du paramètre enableIFrameApi sur true, vous devez toujours spécifier votre domaine comme valeur du paramètre d’origine.
Défaut: ”
Youtube.configure({ origin : ‘votredomaine.com’, })
heure de fin
Ce paramètre spécifie le temps, mesuré en secondes à partir du début de la vidéo, auquel le lecteur doit arrêter la lecture de la vidéo. Par exemple, si vous le définissez sur 15, la vidéo s’arrêtera au bout de 15 secondes.
Par défaut : 0
Youtube.configure({ endTime: ’15’, })
langue de l’interface
Définit la langue de l’interface du lecteur. La valeur du paramètre est un code de langue à deux lettres ISO 639-1. Par exemple, si vous le définissez sur fr, l’interface sera en français.
Par défaut : non défini
Youtube.configure({ interfaceLanguage: ‘fr’, })
ivLoadPolitique
Le réglage sur 1 entraîne l’affichage par défaut des annotations vidéo, tandis que le réglage sur 3 entraîne l’absence d’affichage par défaut des annotations vidéo.
Par défaut : 0
Youtube.configure({ivLoadPolicy: ‘3’, })
boucle
Ce paramètre a une prise en charge limitée dans les intégrations IFrame. Pour lire en boucle une seule vidéo, définissez la valeur du paramètre de boucle sur true et définissez la valeur du paramètre de liste de lecture sur le même ID vidéo déjà spécifié dans l’URL de l’API du lecteur.
Par défaut : faux
Youtube.configure({ boucle : true, })
playlist
Ce paramètre spécifie une liste d’ID vidéo séparés par des virgules à lire.
Défaut: ”
Youtube.configure({ playlist: ‘VIDEO_ID_1,VIDEO_ID_2,VIDEO_ID_3,…,VIDEO_ID_N’, })
modesteBranding
Désactive le logo YouTube sur la barre de contrôle du lecteur. Notez qu’une petite étiquette de texte YouTube s’affiche toujours dans le coin supérieur droit d’une vidéo en pause lorsque le pointeur de la souris de l’utilisateur survole le lecteur
Par défaut : faux
Youtube.configure({modestiqueBranding: true, })
Couleur de la barre de progression
Ce paramètre précise la couleur qui sera utilisée dans la barre de progression vidéo du lecteur. Notez que définir le paramètre color sur blanc désactivera le paramètre modestBranding.
Par défaut : non défini
Youtube.configure({ progressBarColor : ‘blanc’, })
Commandes
définirYoutubeVideo(options)
Insère une iframe YouTube intégrée à la position actuelle
editor.commands.setYoutubeVideo({ src: ‘ largeur: 640, hauteur: 480, })
Options OptionDescriptionOptionalsrcL’url de la vidéo YouTube. Peut être un lien YouTube ou YouTube MusiclargeurLa largeur d’intégration (remplace l’option par défaut, facultatif)✅hauteurLa hauteur d’intégration (remplace l’option par défaut, facultatif)✅
Code source
#Extension #Youtube #Documentation #léditeur #Tiptap
1719546433