github-actions[bot] cc103ce5c9 Release: uppy@4.0.0-beta.5 (#5141) 11 months ago
..
src 5d407087d4 @uppy/form: fix `submitOnSuccess` and `triggerUploadOnSubmit` combination (#5058) 1 year ago
.npmignore 10c085301a @uppy/form: migrate to TS (#4937) 1 year ago
CHANGELOG.md b8f8f8a9dd Release: uppy@4.0.0-beta.4 (#5130) 1 year ago
LICENSE f5bd557e65 Move `Form` to `@uppy/form`. 6 years ago
README.md 7d6937300a meta: enable prettier for markdown (#5133) 11 months ago
package.json cc103ce5c9 Release: uppy@4.0.0-beta.5 (#5141) 11 months ago
tsconfig.build.json 10c085301a @uppy/form: migrate to TS (#4937) 1 year ago
tsconfig.json 10c085301a @uppy/form: migrate to TS (#4937) 1 year ago

README.md

@uppy/form

npm version CI status for Uppy tests CI status for Companion tests CI status for browser tests

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. 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

import Uppy from '@uppy/core'
import Form from '@uppy/form'

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

Installation

$ npm install @uppy/form

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.