uppy/packages/@uppy/form
Artur Paikin 4684a3e1f3
Merge pull request #924 from transloadit/export-plugin
Export Plugin class from @uppy/core.
2018-06-28 09:43:43 -04:00
..
src Export Plugin class from @uppy/core. 2018-06-28 12:20:21 +02:00
types Remove unnecessary declare module wrappers from .d.ts files. 2018-06-18 16:22:15 +02:00
LICENSE Move Form to @uppy/form. 2018-06-14 16:31:19 +02:00
package.json Fix version numbers 2018-06-28 15:41:15 +02:00
README.md Move Form to @uppy/form. 2018-06-14 16:31:19 +02:00

@uppy/form

Uppy logo: a superman puppy in a pink suit

Build Status

The Form plugin collects metadata from any specified <form> element, right before Uppy begins uploading/processing files. It optionally appends results back to the form. Currently the appended result is a stringified version of a result returned from uppy.upload().

Uppy is being developed by the folks at Transloadit, a versatile file encoding service.

Example

const Uppy = require('@uppy/core')
const Form = require('@uppy/form')

const uppy = Uppy()
uppy.use(Form, {
  target: document.querySelector('form'),
  getMetaFromForm: true,
  addResultToForm: true,
  resultName: 'uppyResult',
  submitOnSuccess: true
})

Installation

$ npm install @uppy/form --save

We recommend installing from npm and then using a module bundler such as Webpack, Browserify or Rollup.js.

Alternatively, you can also use this plugin in a pre-built bundle from Transloadit's CDN: Edgly. In that case Uppy will attach itself to the global window.Uppy object. See the main Uppy documentation for instructions.

Documentation

Documentation for this plugin can be found on the Uppy website.

License

The MIT License.