pqina /filepond
🌊 A flexible and fun JavaScript file upload library
★ 16,396⑂ 851👁 158⑃ 183● 883▤ 72
+0
日增长
+5
周增长
+4
月增长
16,396
stars
851
forks
158
watchers
183
prs
883
issues
72
releases
README
A JavaScript library that can upload anything you throw at it, optimizes images for faster uploads, and offers a great, accessible, silky smooth user experience.
!npm
FilePond adapters are available for React, Vue, Angular, Svelte, and jQuery
FilePond v5 Alpha version now available for testing
Documentation • Discord • Examples
---
Buy me a Coffee • Use FilePond with Pintura • Dev updates
---
Core Features
- Accepts directories, files, blobs, local URLs, remote URLs and Data URIs.
- Drop files, select on filesystem, copy and paste files, or add files using the API.
- Async uploads with AJAX, supports chunk uploads, can encode files as base64 data and send along form post.
- Accessible, tested with AT software like VoiceOver and JAWS, navigable by Keyboard.
- Image optimization, automatic image resizing, cropping, filtering, and fixes EXIF orientation.
- Responsive, automatically scales to available space, is functional on both mobile and desktop devices.
Learn more about FilePond
---
Also need Image Editing?
Pintura the modern JavaScript Image Editor is what you're looking for. Pintura supports setting crop aspect ratios, resizing, rotating, cropping, and flipping images. Above all, it integrates beautifully with FilePond.
Learn more about Pintura
---
Live Demos
- React
- Angular
- Svelte
- Vue
Plugins
- File encode
- File rename
- File size validation
- File type validation
- File metadata
- File poster
- Image editor
- Image size validation
- Image preview
- Image crop
- Image filter
- Image resize
- Image transform
- Image EXIF orientation
- Image overlay (nielsboogaard/filepond-plugin-image-overlay)
- Media preview (nielsboogaard/filepond-plugin-media-preview)
- Media preview + PDF preview (ErnestBrandi/filepond-plugin-media-preview)
- Get file (nielsboogaard/filepond-plugin-get-file)
- Zip Directory Uploads (tzsk/filepond-plugin-zipper)
- PDF Preview (Adri-Glez/filepond-plugin-pdf-preview)
- PDF Convert (alexandreDavid/filepond-plugin-pdf-convert)
Adapters
- React
- Vue
- Svelte
- jQuery
- Angular
- Angular 1 (johnnyasantoss/angularjs-filepond)
- Blazor (soenneker/soenneker.blazor.filepond)
- Ember (alexdiliberto/ember-filepond)
Backend
- PHP
- Django (ImperialCollegeLondon/django-drf-filepond)
- Laravel (Sopamo/laravel-filepond)
- Laravel (Albert221/laravel-filepond)
- SilverStripe (lekoala/silverstripe-filepond)
- Ruby on Rails (Code-With-Rails/filepond-rails)
Quick Start
Install using npm:
bash
npm install filepond
Then import in your project:
js
import as FilePond from 'filepond';
// Create a multi file upload component
const pond = FilePond.create({
multiple: true,
name: 'filepond',
});
// Add it to the DOM
document.body.appendChild(pond.element);
Or get it from a CDN:
html
FilePond from CDN
Top issues
#243Tick function active when not using FilePond19 comments · 2018-12-16#613Ability to edit and remove for local files14 comments · 2020-11-16#681Filepond UI error message doesn't go away when files that exceed the limit are removed13 comments · 2021-03-26#622filepond gives error while using with iframe, it will throw `Uncaught TypeError: Cannot read property 'removeChild'13 comments · 2020-12-11#174If multiple files allowed don't automatically allow selection of multiple files on file system13 comments · 2018-11-26#150Handle long validation message at mobile page width12 comments · 2018-10-22#888[Bug] Vue FilePond v-on:processfiles not working, event is not firing.11 comments · 2023-01-31#166Filepond doesnt work with android 4.1, 4.2, 4.4, 5.0, 6.0 (emulator) plain browser11 comments · 2018-11-16
Latest release
4.28.2 4.28.2 2021-06-09- Fix issue where local server files could not be re-uploaded after editing and did not trigger remove of source file.