|
|
před 1 rokem | |
|---|---|---|
| .. | ||
| README.md | před 1 rokem | |
| k-theme-primary.css | před 1 rokem | |
| kserver.js | před 1 rokem | |
KServerBrowser est un composant de navigateur de fichiers simple et moderne pour les applications web. Il permet de parcourir une arborescence de fichiers et dossiers, de sélectionner des fichiers avec prévisualisation, et de gérer la navigation avec un système de breadcrumbs.
<script src="kserver.js"></script>
import { NSEServerBrowser } from './kserver.js';
const browser = new NSEServerBrowser({
containerId: 'my-container',
dataSource: '/api/files',
theme: 'primary',
lang: 'fr',
acceptedTypeFiles: ['jpg', 'png', 'pdf'],
onValidate: (file) => {
console.log('Fichier sélectionné:', file);
}
});
// Ouvrir le navigateur
browser.open();
const browser = new NSEServerBrowser({
// Conteneur (obligatoire)
containerId: 'file-browser', // ID du conteneur HTML
// Source de données (obligatoire)
dataSource: '/api/files', // URL ou tableau de données
// Apparence
theme: 'primary', // Thème CSS ou URL de fichier CSS
icons: {
folder: '📁',
file: '📄',
image: '🖼️'
},
// Comportement
lang: 'fr', // Langue (fr, en, es, de)
langModule: {
validate: 'Confirmer',
back: 'Retour'
},
acceptedTypeFiles: ['jpg', 'png', 'pdf'], // Extensions acceptées
autoHideEmptyFolders: true, // Masquer les dossiers vides
// Callbacks
onValidate: (file) => {
// Fichier sélectionné et validé
console.log('Fichier:', file.file);
console.log('Dossier:', file.folder);
},
onFileClick: (file) => {
// Fichier cliqué (avant validation)
console.log('Fichier cliqué:', file);
}
});
{
"data": [
{
"type": "folder",
"name": "images",
"children": [
{
"type": "file",
"name": "photo.jpg",
"previewURL": "/thumbnails/photo.jpg",
"url": "/files/photo.jpg"
}
]
}
]
}
| Propriété | Type | Description |
|---|---|---|
type |
string | "folder" ou "file" |
name |
string | Nom du fichier/dossier |
children |
array | Enfants du dossier (dossiers uniquement) |
previewURL |
string | URL de prévisualisation (fichiers) |
url |
string | URL du fichier (fichiers) |
disabled |
boolean | Désactiver l'élément |
.kcontainer { /* Conteneur principal */ }
.kheader { /* En-tête avec breadcrumbs */ }
.k-breadcrumb { /* Fil d'Ariane */ }
.kfile-tree { /* Arbre de fichiers */ }
.kfolder { /* Dossier */ }
.kfile { /* Fichier */ }
.kfile.selected { /* Fichier sélectionné */ }
.kfooter { /* Pied de page avec boutons */ }
.k-validate-btn { /* Bouton de validation */ }
.k-preview-btn { /* Bouton de prévisualisation */ }
primary : Thème principalsecondary : Thème secondairedark : Thème sombre'https://example.com/theme.css'open()Ouvre le navigateur de fichiers
browser.open();
destroy()Ferme le navigateur et nettoie les ressources
browser.destroy();
getSelectedFiles()Retourne le fichier actuellement sélectionné
const selectedFile = browser.getSelectedFiles();
goBack()Retourne au dossier précédent
browser.goBack();
kserverbrowser:closedDéclenché quand le navigateur est fermé
document.addEventListener('kserverbrowser:closed', (e) => {
console.log('Navigateur fermé pour:', e.detail.containerId);
});
fr) : Valider, Retour, Prévisualiser, Fermer, Racineen) : Validate, Back, Preview, Close, Rootes) : Confirmar, Atrás, Vista previa, Cerrar, Raízde) : Bestätigen, Zurück, Vorschau, Schließen, Wurzelconst browser = new NSEServerBrowser({
lang: 'fr',
langModule: {
validate: 'Confirmer',
back: 'Précédent',
preview: 'Aperçu'
}
});
const imageBrowser = new NSEServerBrowser({
containerId: 'image-selector',
dataSource: '/api/images',
acceptedTypeFiles: ['jpg', 'png', 'gif', 'webp'],
theme: 'primary',
lang: 'fr',
onValidate: (file) => {
// Insérer l'image dans un éditeur
insertImageIntoEditor(file.file);
}
});
const docBrowser = new NSEServerBrowser({
containerId: 'doc-manager',
dataSource: '/api/documents',
acceptedTypeFiles: ['pdf', 'doc', 'docx'],
autoHideEmptyFolders: true,
onValidate: (file) => {
// Ouvrir le document
window.open(file.file.url, '_blank');
}
});
// Vérifier que l'élément existe
const container = document.getElementById('my-container');
if (!container) {
console.error('Conteneur non trouvé');
}
// Vérifier l'URL et la structure des données
fetch('/api/files')
.then(response => response.json())
.then(data => console.log(data));
// Toujours définir le callback onValidate
const browser = new NSEServerBrowser({
// ... autres options
onValidate: (file) => {
console.log('Fichier sélectionné:', file);
}
});
Ce composant est développé pour le projet NewSiteEditor et est destiné à un usage interne.
Pour contribuer à ce composant :
Pour toute question ou problème :