This is the documentation for Superforms version 1. The latest version can
be found at superforms.rocks!
Submit behavior
When the user submits a form, it’s important for the user experience to show that things are processing. Superforms provides you with loading timers and the following options for this:
Usage
const { form, enhance } = superForm(data.form, {
clearOnSubmit: 'errors' | 'message' | 'errors-and-message' | 'none' = 'errors-and-message'
multipleSubmits: 'prevent' | 'allow' | 'abort' = 'prevent'
})
clearOnSubmit
The clearOnSubmit option decides what should happen to the form when submitting. It can clear all the errors, the message, both, or none. The default is to clear both.
If you don’t want any jumping content, which could occur when error messages are removed from the DOM, setting it to one of the other options can be useful.
multipleSubmits
This one handles the occurence of multiple form submissions, before a result has been returned.
- When set to
prevent, the form cannot be submitted again until a result is returned, or thetimeoutstate is reached (see the section about loading timers). abortis the next sensible approach, which will cancel the previous request before submitting again.- Finally,
allowwill pass through any number of frenetic clicks on the submit button!