Adding (temporarily) onBeforeSubmit prop to <Form> (+ docs). Fixes #637

Author: davidkpiano

docs/api/Form.md

@@ -231,5 +231,17 @@ _(Function)_ Provides the dispatcher for the `<Form>`'s store.
 />
 ```
 
+## `onBeforeSubmit={(event) => ...}`
+_(Function)_ Called every time a `submit` event is emitted from the form.
+
+(since: 1.6.1 - note: this is temporary and likely to be removed in version 2.0)
+
+```jsx
+<Form
+  model="user"
+  onBeforeSubmit={(event) => /* ... */}
+/>
+```
+
 ### Notes
 - This is most useful for use with `<LocalForm>`, and is primarily intended for `<LocalForm>`.

src/components/form-component.js

@@ -47,6 +47,7 @@ const propTypes = {
   onChange: PropTypes.func,
   getRef: PropTypes.func,
   getDispatch: PropTypes.func,
+  onBeforeSubmit: PropTypes.func,
 
   // standard HTML attributes
   action: PropTypes.string,
@@ -337,8 +338,11 @@ function createFormClass(s = defaultStrategy) {
         formValue,
         onSubmit,
         validators,
+        onBeforeSubmit,
       } = this.props;
 
+      if (onBeforeSubmit) onBeforeSubmit(e);
+
       const formValid = formValue
         ? formValue.$form.valid
         : true;