Intersel 9c212bcdbc 1e refactoring avec cursor... à continuer... 1 năm trước cách đây
..
README.md 9c212bcdbc 1e refactoring avec cursor... à continuer... 1 năm trước cách đây
VideoEditor.js 9c212bcdbc 1e refactoring avec cursor... à continuer... 1 năm trước cách đây

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.