> For the complete documentation index, see [llms.txt](https://jscula.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jscula.gitbook.io/docs/events/event-listener/onsubmit.md).

# onSubmit

add on submit event

```
onSubmit(callback,?options)
```

### Adding submit event

```javascript
$('#form').onSubmit(function(e){
   //perform action here
   this.serialize(); // get the form data as json
   //or
   this.formData() // this returns new FormData object for your ajax and file upload
   
   e.preventDefault();
    //process form and then submit
});
```

### Use cases

Use `onSubmit()` to validate or process form data before submission.

### More examples

Display a save status without submitting the form:

```javascript
$('#profile-form').onSubmit(function(e) {
  e.preventDefault();
  const values = this.serialize();
  $('#status').text(`Saving ${values.email}`);
});
```