Intersel 9c212bcdbc 1e refactoring avec cursor... à continuer... 1 年之前
..
README.md 9c212bcdbc 1e refactoring avec cursor... à continuer... 1 年之前
VideoEditor.js 9c212bcdbc 1e refactoring avec cursor... à continuer... 1 年之前

README.md

Modules du NewSiteEditor

Ce dossier contient les modules fonctionnels extraits du fichier principal index.js pour une meilleure organisation et maintenabilité du code.

Structure des modules

VideoEditor.js

  • Fonction principale : nseVideoEditor(enable)
  • Description : Gère l'éditeur vidéo complet du NewSiteEditor
  • Fonctionnalités :
    • Modification de la source vidéo
    • Édition du poster (image de prévisualisation)
    • Modification du titre et de l'aria-label
    • Upload de fichiers via Uppy
    • Intégration avec le gestionnaire de fichiers Karibsen
    • Interface modale multi-étapes

Dépendances

Dépendances externes

  • Uppy : Gestion des uploads de fichiers
  • Video.js : Lecteur vidéo
  • Karibsen.ServerBrowser : Gestionnaire de fichiers serveur
  • jQuery : Fonctions utilitaires (imxLoaderDisplay, etc.)

Dépendances internes

  • Modal : Classe pour la gestion des modales
  • Configuration globale : baseURL, lang, acceptedImageTypes, acceptedVideoTypes

Utilisation

Import du module

import { nseVideoEditor } from './modules/VideoEditor.js';

Activation/Désactivation

// Activer l'éditeur vidéo
nseVideoEditor(true);

// Désactiver l'éditeur vidéo
nseVideoEditor(false);

Fonctionnalités détaillées

1. Gestion des vidéos

  • Détection automatique des éléments .videoeditor
  • Extraction des informations vidéo (poster, titre, aria-label, source)
  • Mise à jour en temps réel des propriétés

2. Interface utilisateur

  • Modal multi-étapes (poster → vidéo)
  • Bouton flottant positionnable
  • Gestion des événements clavier (Escape pour fermer)

3. Upload de fichiers

  • Support des images (poster) : .jpg, .jpeg, .png, .gif, .webp
  • Support des vidéos : .mp4, .webm
  • Validation des types de fichiers
  • Compression et optimisation automatiques

4. Intégration serveur

  • Upload via API REST (/rest/newsiteeditor/image/, /rest/newsiteeditor/video/)
  • Mise à jour des métadonnées (/rest/newsiteeditor/video/{id})
  • Gestion des erreurs et feedback utilisateur

Variables d'état

Le module gère ses propres variables d'état :

  • posterUppy : Instance Uppy pour les images
  • videoUppy : Instance Uppy pour les vidéos
  • isVideoEditorSetup : État d'initialisation des événements

Notes importantes

  1. Isolation : Le module est complètement autonome et gère ses propres dépendances
  2. Performance : Les instances Uppy sont réutilisées pour éviter les re-créations
  3. Compatibilité : Fonctionne avec l'architecture existante du NewSiteEditor
  4. Extensibilité : Facilement modifiable pour ajouter de nouvelles fonctionnalités

Tests

Un fichier de test test-video.html est fourni pour vérifier le bon fonctionnement du module.

Migration depuis l'ancienne version

L'ancienne fonction nseVideoEditor a été complètement extraite du fichier principal. Le module conserve exactement la même API et le même comportement, garantissant une compatibilité totale.