À propos du projet
Dropzone est une bibliothèque JavaScript qui transforme n'importe quel élément HTML en zone de dépôt : les utilisateurs peuvent glisser-déposer des fichiers dessus, et la bibliothèque affiche les aperçus des fichiers et la progression du téléversement tout en gérant le téléversement via XHR. Elle est écrite en TypeScript et fournit ses propres définitions de types, donc aucun package @types séparé n'est nécessaire. Le README note que l'ancien @types/dropzone s'est arrêté à la version 5.7.9 et décrit l'API v5, il doit donc être supprimé s'il est présent.
L'installation se fait via npm (npm install dropzone) ou pnpm, et elle peut être utilisée comme module ES6 ou module CommonJS. Pour les projets sans gestionnaire de paquets ou bundler, des fichiers autonomes sont disponibles sur unpkg, exposant Dropzone comme variable globale, ainsi qu'une feuille de style.
Les fonctionnalités documentées incluent : un style par défaut attrayant ; des aperçus de vignettes d'images via un rappel thumbnail(file, data) ; la prise en charge des écrans haute densité ; plusieurs fichiers et téléversements synchrones ; les mises à jour de progression ; la prise en charge des gros fichiers grâce aux téléversements fractionnés ; la prise en charge du téléversement multipart Amazon S3 ; une personnalisation complète en remplaçant les écouteurs d'événements par défaut ; et le redimensionnement des images côté navigateur avant le téléversement. Le README indique que la bibliothèque est bien testée.
Le dépôt est un monorepo contenant la bibliothèque publiée sur npm sous le nom dropzone (packages/dropzone), la documentation construite avec Docusaurus (apps/docs), et le site web construit avec SvelteKit (apps/website). Les commandes de développement incluent pnpm install, pnpm build, pnpm test, pnpm test:e2e, pnpm dev:docs et pnpm dev:website. Une seule commande pnpm build:site produit le site GitHub Pages déployable dans _site/, combinant le site web à la racine et la documentation sous /docs ; le CI exécute le même script.
Dropzone 6 ne prend pas en charge Internet Explorer ; la version 5.9.3 est suggérée pour ce besoin. Le support communautaire est orienté vers GitHub Discussions ou Stack Overflow avec le tag dropzone.js plutôt que vers le suivi de problèmes, qui est réservé aux rapports de bugs. Le projet est sous licence MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.