Skip to content

Commit

Permalink
v7.4.0
Browse files Browse the repository at this point in the history
  • Loading branch information
@erikras
erikras committed Jun 12, 2018
1 parent 83b79a7 commit f2b8377
Show file tree
Hide file tree
Showing 78 changed files with 37,366 additions and 56,683 deletions.
36 changes: 18 additions & 18 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -31,29 +31,29 @@ Redux-form is proudly sponsored by [Rollbar](https://codesponsor.io/t/c/07f83dcd

## Documentation

* [Getting Started](https://redux-form.com/7.3.0/docs/GettingStarted.md/)
* [Examples](https://redux-form.com/7.3.0/examples/)
* [API](https://redux-form.com/7.3.0/docs/api/)
* [FAQ](https://redux-form.com/7.3.0/docs/faq/)
* [Release Notes](https://github.com/erikras/redux-form/releases)
* [Older Documentation](https://redux-form.com/7.3.0/docs/DocumentationVersions.md/)
- [Getting Started](https://redux-form.com/7.4.0/docs/GettingStarted.md/)
- [Examples](https://redux-form.com/7.4.0/examples/)
- [API](https://redux-form.com/7.4.0/docs/api/)
- [FAQ](https://redux-form.com/7.4.0/docs/faq/)
- [Release Notes](https://github.com/erikras/redux-form/releases)
- [Older Documentation](https://redux-form.com/7.4.0/docs/DocumentationVersions.md/)

## 🏖 Code Sandboxes 🏖

You can play around with `redux-form` in these sandbox versions of the Examples.

* [Simple Form](https://codesandbox.io/s/mZRjw05yp)
* [Synchronous Validation](https://codesandbox.io/s/pQj03w7Y6)
* [Field-Level Validation](https://codesandbox.io/s/PNQYw1kVy)
* [Submit Validation](https://codesandbox.io/s/XoA5vXDgA)
* [Asynchronous Blur Validation](https://codesandbox.io/s/nKlYo387)
* [Initializing From State](https://codesandbox.io/s/MQnD536Km)
* [Field Arrays](https://codesandbox.io/s/Ww4QG1Wx)
* [Remote Submit](https://codesandbox.io/s/ElYvJR21K)
* [Normalizing](https://codesandbox.io/s/L8KWERjDw)
* [Immutable JS](https://codesandbox.io/s/ZVGJQBJMw)
* [Selecting Form Values](https://codesandbox.io/s/gJOBWZMRZ)
* [Wizard Form](https://codesandbox.io/s/0Qzz3843)
- [Simple Form](https://codesandbox.io/s/mZRjw05yp)
- [Synchronous Validation](https://codesandbox.io/s/pQj03w7Y6)
- [Field-Level Validation](https://codesandbox.io/s/PNQYw1kVy)
- [Submit Validation](https://codesandbox.io/s/XoA5vXDgA)
- [Asynchronous Blur Validation](https://codesandbox.io/s/nKlYo387)
- [Initializing From State](https://codesandbox.io/s/MQnD536Km)
- [Field Arrays](https://codesandbox.io/s/Ww4QG1Wx)
- [Remote Submit](https://codesandbox.io/s/ElYvJR21K)
- [Normalizing](https://codesandbox.io/s/L8KWERjDw)
- [Immutable JS](https://codesandbox.io/s/ZVGJQBJMw)
- [Selecting Form Values](https://codesandbox.io/s/gJOBWZMRZ)
- [Wizard Form](https://codesandbox.io/s/0Qzz3843)

## Videos

Expand Down
120 changes: 60 additions & 60 deletions docs/DocumentationVersions.md
View file
Original file line number Diff line number Diff line change
@@ -1,62 +1,62 @@
# Documentation Versions

* [7.3.0](https://redux-form.com/7.3.0/)
* [7.2.0](https://redux-form.com/7.2.0/)
* [7.1.2](https://redux-form.com/7.1.2/)
* [7.1.1](https://redux-form.com/7.1.1/)
* [7.1.0](https://redux-form.com/7.1.0/)
* [7.0.4](https://redux-form.com/7.0.4/)
* [7.0.3](https://redux-form.com/7.0.3/)
* [7.0.2](https://redux-form.com/7.0.2/)
* [7.0.1](https://redux-form.com/7.0.1/)
* [7.0.0](https://redux-form.com/7.0.0/)
* [6.8.0](https://redux-form.com/6.8.0/)
* [6.7.0](https://redux-form.com/6.7.0/)
* [6.6.3](https://redux-form.com/6.6.3/)
* [6.6.2](https://redux-form.com/6.6.2/)
* [6.6.1](https://redux-form.com/6.6.1/)
* [6.6.0](https://redux-form.com/6.6.0/)
* [6.5.0](https://redux-form.com/6.5.0/)
* [6.4.3](https://redux-form.com/6.4.3/)
* [6.4.2](https://redux-form.com/6.4.2/)
* [6.4.1](https://redux-form.com/6.4.1/)
* [6.4.0](https://redux-form.com/6.4.0/)
* [6.3.1](https://redux-form.com/6.3.1/)
* [6.3.0](https://redux-form.com/6.3.0/)
* [6.2.1](https://redux-form.com/6.2.1/)
* [6.2.0](https://redux-form.com/6.2.0/)
* [6.1.1](https://redux-form.com/6.1.1/)
* [6.1.0](https://redux-form.com/6.1.0/)
* [6.0.5](https://redux-form.com/6.0.5/)
* [6.0.4](https://redux-form.com/6.0.4/)
* [6.0.2](https://redux-form.com/6.0.2/)
* [6.0.1](https://redux-form.com/6.0.1/)
* [6.0.0-rc.5](https://redux-form.com/6.0.0-rc.5/)
* [6.0.0-rc.4](https://redux-form.com/6.0.0-rc.4/)
* [6.0.0-rc.3](https://redux-form.com/6.0.0-rc.3/)
* [6.0.0-rc.2](https://redux-form.com/6.0.0-rc.2/)
* [6.0.0-rc.1](https://redux-form.com/6.0.0-rc.1/)
* [6.0.0-alpha.15](https://redux-form.com/6.0.0-alpha.15/)
* [6.0.0-alpha.14](https://redux-form.com/6.0.0-alpha.14/)
* [6.0.0-alpha.13](https://redux-form.com/6.0.0-alpha.13/)
* [6.0.0-alpha.11](https://redux-form.com/6.0.0-alpha.11/)
* [6.0.0-alpha.10](https://redux-form.com/6.0.0-alpha.10/)
* [6.0.0-alpha.8](https://redux-form.com/6.0.0-alpha.8/)
* [6.0.0-alpha.7](https://redux-form.com/6.0.0-alpha.7/)
* [6.0.0-alpha.6](https://redux-form.com/6.0.0-alpha.6/)
* [6.0.0-alpha.5](https://redux-form.com/6.0.0-alpha.5/)
* [6.0.0-alpha.4](https://redux-form.com/6.0.0-alpha.4/)
* [5.3.6](https://redux-form.com/5.3.6/)
* [5.3.1](https://redux-form.com/5.3.1/)
* [5.3.0](https://redux-form.com/5.3.0/)
* [5.2.5](https://redux-form.com/5.2.5/)
* [5.2.4](https://redux-form.com/5.2.4/)
* [5.2.3](https://redux-form.com/5.2.3/)
* [5.2.1](https://redux-form.com/5.2.1/)
* [5.2.0](https://redux-form.com/5.2.0/)
* [5.1.3](https://redux-form.com/5.1.3/)
* [5.1.1](https://redux-form.com/5.1.1/)
* [5.1.0](https://redux-form.com/5.1.0/)
* [5.0.1](https://redux-form.com/5.0.1/)
* [5.0.0](https://redux-form.com/5.0.0/)
* [4.2.0](https://redux-form.com/4.2.0/)
- [7.4.0](https://redux-form.com/7.4.0/)
- [7.2.0](https://redux-form.com/7.2.0/)
- [7.1.2](https://redux-form.com/7.1.2/)
- [7.1.1](https://redux-form.com/7.1.1/)
- [7.1.0](https://redux-form.com/7.1.0/)
- [7.0.4](https://redux-form.com/7.0.4/)
- [7.0.3](https://redux-form.com/7.0.3/)
- [7.0.2](https://redux-form.com/7.0.2/)
- [7.0.1](https://redux-form.com/7.0.1/)
- [7.0.0](https://redux-form.com/7.0.0/)
- [6.8.0](https://redux-form.com/6.8.0/)
- [6.7.0](https://redux-form.com/6.7.0/)
- [6.6.3](https://redux-form.com/6.6.3/)
- [6.6.2](https://redux-form.com/6.6.2/)
- [6.6.1](https://redux-form.com/6.6.1/)
- [6.6.0](https://redux-form.com/6.6.0/)
- [6.5.0](https://redux-form.com/6.5.0/)
- [6.4.3](https://redux-form.com/6.4.3/)
- [6.4.2](https://redux-form.com/6.4.2/)
- [6.4.1](https://redux-form.com/6.4.1/)
- [6.4.0](https://redux-form.com/6.4.0/)
- [6.3.1](https://redux-form.com/6.3.1/)
- [6.3.0](https://redux-form.com/6.3.0/)
- [6.2.1](https://redux-form.com/6.2.1/)
- [6.2.0](https://redux-form.com/6.2.0/)
- [6.1.1](https://redux-form.com/6.1.1/)
- [6.1.0](https://redux-form.com/6.1.0/)
- [6.0.5](https://redux-form.com/6.0.5/)
- [6.0.4](https://redux-form.com/6.0.4/)
- [6.0.2](https://redux-form.com/6.0.2/)
- [6.0.1](https://redux-form.com/6.0.1/)
- [6.0.0-rc.5](https://redux-form.com/6.0.0-rc.5/)
- [6.0.0-rc.4](https://redux-form.com/6.0.0-rc.4/)
- [6.0.0-rc.3](https://redux-form.com/6.0.0-rc.3/)
- [6.0.0-rc.2](https://redux-form.com/6.0.0-rc.2/)
- [6.0.0-rc.1](https://redux-form.com/6.0.0-rc.1/)
- [6.0.0-alpha.15](https://redux-form.com/6.0.0-alpha.15/)
- [6.0.0-alpha.14](https://redux-form.com/6.0.0-alpha.14/)
- [6.0.0-alpha.13](https://redux-form.com/6.0.0-alpha.13/)
- [6.0.0-alpha.11](https://redux-form.com/6.0.0-alpha.11/)
- [6.0.0-alpha.10](https://redux-form.com/6.0.0-alpha.10/)
- [6.0.0-alpha.8](https://redux-form.com/6.0.0-alpha.8/)
- [6.0.0-alpha.7](https://redux-form.com/6.0.0-alpha.7/)
- [6.0.0-alpha.6](https://redux-form.com/6.0.0-alpha.6/)
- [6.0.0-alpha.5](https://redux-form.com/6.0.0-alpha.5/)
- [6.0.0-alpha.4](https://redux-form.com/6.0.0-alpha.4/)
- [5.3.6](https://redux-form.com/5.3.6/)
- [5.3.1](https://redux-form.com/5.3.1/)
- [5.3.0](https://redux-form.com/5.3.0/)
- [5.2.5](https://redux-form.com/5.2.5/)
- [5.2.4](https://redux-form.com/5.2.4/)
- [5.2.3](https://redux-form.com/5.2.3/)
- [5.2.1](https://redux-form.com/5.2.1/)
- [5.2.0](https://redux-form.com/5.2.0/)
- [5.1.3](https://redux-form.com/5.1.3/)
- [5.1.1](https://redux-form.com/5.1.1/)
- [5.1.0](https://redux-form.com/5.1.0/)
- [5.0.1](https://redux-form.com/5.0.1/)
- [5.0.0](https://redux-form.com/5.0.0/)
- [4.2.0](https://redux-form.com/4.2.0/)
8 changes: 4 additions & 4 deletions docs/Flow.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Inside your `.flowconfig`, ensure the entire folder is not ignored:
## Props Types

This will give you the types of the
[`props`](http://redux-form.com/7.3.0/docs/api/Props.md/) that will be injected
[`props`](http://redux-form.com/7.4.0/docs/api/Props.md/) that will be injected
into your decorated form component by the `reduxForm()` higher order component.

### `FormProps`
Expand All @@ -51,7 +51,7 @@ class MyForm extends React.Component {
### `FieldProps`

This will give you the shape of the props provided from
[`Field`](http://redux-form.com/7.3.0/docs/api/Field.md/) to your field
[`Field`](http://redux-form.com/7.4.0/docs/api/Field.md/) to your field
component.

```jsx
Expand All @@ -72,7 +72,7 @@ const renderField = ({ input, meta, ...rest } : FieldProps) =>
### `FieldsProps`

This will give you the shape of the props provided from
[`Fields`](http://redux-form.com/7.3.0/docs/api/Fields.md/) to your fields
[`Fields`](http://redux-form.com/7.4.0/docs/api/Fields.md/) to your fields
component.

```jsx
Expand All @@ -97,7 +97,7 @@ const renderField = (fields : FieldsProps) =>
### `FieldArrayProps`

This will give you the shape of the props provided from
[`FieldArray`](http://redux-form.com/7.3.0/docs/api/FieldArray.md/) to your
[`FieldArray`](http://redux-form.com/7.4.0/docs/api/FieldArray.md/) to your
field array component.

```jsx
Expand Down
28 changes: 14 additions & 14 deletions docs/GettingStarted.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,17 @@
The basic implementation of `redux-form` is simple. However, to make the most of
it, it's recommended to have basic knowledge on:

* [Redux](http://redux.js.org/) state container,
* [React](https://facebook.github.io/react/) and
- [Redux](http://redux.js.org/) state container,
- [React](https://facebook.github.io/react/) and
[Higher-Order Components (HOCs)](https://facebook.github.io/react/docs/higher-order-components.html).

## Overview

To connect your React form components to your Redux store you'll need the following
pieces from the `redux-form` package:

* Redux Reducer: `formReducer`,
* React HOC `reduxForm()` and `<Field/>` component.
- Redux Reducer: `formReducer`,
- React HOC `reduxForm()` and `<Field/>` component.

It's important to understand their responsibilities:

Expand All @@ -27,7 +27,7 @@ It's important to understand their responsibilities:

The diagram below represents the simplified data flow. Note that in most cases
you don't need to worry about the
[action creators](http://redux-form.com/7.3.0/docs/api/ActionCreators.md/) for
[action creators](http://redux-form.com/7.4.0/docs/api/ActionCreators.md/) for
yourself, as they're already bound to dispatch for certain actions.

<div style="text-align: center;">
Expand Down Expand Up @@ -76,7 +76,7 @@ Now your store knows how to handle actions coming from the form components.

**NOTE:** The key used to pass the `redux-form` reducer should be named
**`form`**. If you need a custom key for some reason see
[`getFormState` config](http://redux-form.com/7.3.0/docs/api/ReduxForm.md/#-getformstate-function-optional-)
[`getFormState` config](http://redux-form.com/7.4.0/docs/api/ReduxForm.md/#-getformstate-function-optional-)
for more details.

### Step 2 of 4: Form component
Expand Down Expand Up @@ -134,7 +134,7 @@ maintain the input state under the hood.

**NOTE**: `<Field/>` component is much more powerful. Apart from basic input
types, it can take a class or a stateless component. When you're ready, go to
the [docs](http://redux-form.com/7.3.0/docs/api/Field.md/#usage) to find out
the [docs](http://redux-form.com/7.4.0/docs/api/Field.md/#usage) to find out
more.

Let's finish up our contact form:
Expand Down Expand Up @@ -196,12 +196,12 @@ class ContactPage extends React.Component {
```

You can now take it from here. We recommend to check out the
[examples](http://redux-form.com/7.3.0/examples/). The common next steps could
[examples](http://redux-form.com/7.4.0/examples/). The common next steps could
also be:

* setting the
[initial form values](http://redux-form.com/7.3.0/examples/initializeFromState/),
* implementing the
[validation](http://redux-form.com/7.3.0/examples/syncValidation/),
* creating dynamic forms with
[arrays of fields](http://redux-form.com/7.3.0/examples/fieldArrays/).
- setting the
[initial form values](http://redux-form.com/7.4.0/examples/initializeFromState/),
- implementing the
[validation](http://redux-form.com/7.4.0/examples/syncValidation/),
- creating dynamic forms with
[arrays of fields](http://redux-form.com/7.4.0/examples/fieldArrays/).
9 changes: 6 additions & 3 deletions docs/MigrationGuide.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,10 @@ import { reduxForm } from 'redux-form'

class MyForm extends Component {
render() {
const { fields: { username, password }, handleSubmit } = this.props
const {
fields: { username, password },
handleSubmit
} = this.props

return (
<form onSubmit={handleSubmit}>
Expand Down Expand Up @@ -315,8 +318,8 @@ const upper = value => value && value.toUpperCase()
```

See the
[Normalizing Example](https://redux-form.com/7.3.0/examples/normalizing/) and
[Value Lifecycle](https://redux-form.com/7.3.0/docs/ValueLifecycle.md/) for more
[Normalizing Example](https://redux-form.com/7.4.0/examples/normalizing/) and
[Value Lifecycle](https://redux-form.com/7.4.0/docs/ValueLifecycle.md/) for more
details.

## Listening to other actions
Expand Down
2 changes: 1 addition & 1 deletion docs/api/Fields.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -164,7 +164,7 @@ component.
## Props

The props that `Fields` will pass to your component are
[the same `input` and `meta` structures that `Field` generates](https://redux-form.com/7.3.0/docs/api/Field.md/#props),
[the same `input` and `meta` structures that `Field` generates](https://redux-form.com/7.4.0/docs/api/Field.md/#props),
except that they are broken up into the structure of the fields you gave as
`names`.

Expand Down
12 changes: 6 additions & 6 deletions docs/api/Form.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,15 @@ allows the surrounding `redux-form`-decorated component to trigger its

It is only useful if you are:

* performing your submission from inside your form component by passing
- performing your submission from inside your form component by passing
`onSubmit={this.props.handleSubmit(this.mySubmitFunction)}` to your `<form>`
component
* **AND EITHER:**
* initiating your submission via the
[`submit()` Instance API](http://redux-form.com/7.3.0/docs/api/ReduxForm.md/#-submit-promise-)
- **AND EITHER:**
- initiating your submission via the
[`submit()` Instance API](http://redux-form.com/7.4.0/docs/api/ReduxForm.md/#-submit-promise-)
(i.e. calling it directly on a reference to your decorated form component)
* initiating your submission by
[dispatching the `submit(form)` action](http://redux-form.com/7.3.0/examples/remoteSubmit/)
- initiating your submission by
[dispatching the `submit(form)` action](http://redux-form.com/7.4.0/examples/remoteSubmit/)

If you are passing in your `onSubmit` function as a config parameter or prop,
this component will do nothing for you.
Expand Down
4 changes: 2 additions & 2 deletions docs/api/FormValueSelector.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ import { formValueSelector } from 'redux-form' // ES6

> The name of the form you are connecting to. Must be the same as the `form`
> config value you gave to
> [`reduxForm()`](https://redux-form.com/7.3.0/docs/api/ReduxForm.md/).
> [`reduxForm()`](https://redux-form.com/7.4.0/docs/api/ReduxForm.md/).
### `getFormState : Function` [optional]

Expand Down Expand Up @@ -89,5 +89,5 @@ connect(state => selector(state, 'first', 'second'))(MyFormComponent)
## Example

See the
[Selecting Form Values](https://redux-form.com/7.3.0/examples/selectingFormValues/)
[Selecting Form Values](https://redux-form.com/7.4.0/examples/selectingFormValues/)
example.
2 changes: 1 addition & 1 deletion docs/api/FormValues.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ import { formValues } from 'redux-form' // ES6
### name

The path to the field, exactly like the `name` parameter of
[`<Field/>`](https://redux-form.com/7.3.0/docs/api/Field.md/).
[`<Field/>`](https://redux-form.com/7.4.0/docs/api/Field.md/).

### options: {prop: name, ...}

Expand Down
8 changes: 4 additions & 4 deletions docs/api/Props.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
> The `props` listed on this page are the `props` that `redux-form` generates to
> give to your decorated form component. The `props` that _you pass into your
> wrapped component_ are listed
> [here](https://redux-form.com/7.3.0/docs/api/ReduxForm.md/).
> [here](https://redux-form.com/7.4.0/docs/api/ReduxForm.md/).
> If you are a strict `PropTypes` completionist, `redux-form` exports all of
> these
Expand Down Expand Up @@ -95,10 +95,10 @@ class SimpleForm extends Component {

> This value will be either:
>
> * `false` - No asynchronous validation is currently happening
> * `true` - Asynchronous validation is currently running in preparation to
> - `false` - No asynchronous validation is currently happening
> - `true` - Asynchronous validation is currently running in preparation to
> submit a form
> * a `string` - The name of the field that just blurred to trigger asynchronous
> - a `string` - The name of the field that just blurred to trigger asynchronous
> validation
### `autofill(field:String, value:any) : Function`
Expand Down
Loading

0 comments on commit f2b8377

Please sign in to comment.