redux-actions-class

Create action creators and types with minimal redundancy.

Install

1npm i redux-actions-class --save

Why not redux-actions or redux-act?

The benefits of this package compared to redux-actions is that you don't have to manage a separate actionTypes file; you get to define actions on an orderly object literal and all your types and creators will live on just one object. Just a matter of preference.

Considering redux-act, we achieve a similar goal of not having to declare or manage string constants, however, this package still enforces the SCREAMING_UNDERSCORE_CASING we are so used to.

In any case, both of those package offer some goodies beyond actions, like higher level reducer creators. For that I recommend coupling this package with redux-create-reducer - from the example in the redux reducing boilerplate section. As far as FSA enforcement goes, I got nothing but am open to PRs and suggestions.

Example

1import Actions from 'redux-actions-class'
2import { assert } from 'chai'
3
4const actions = new Actions({
5  
6  // use falsy value for actions with no payloads
7  DISPLAY_COLORS: null,
8  
9  // use string for single argument (like payload, if you use FSAs)
10  ADD_COLOR: 'color',
11  
12  // use array for multiple arguments
13  MIX_COLORS: ['color1', 'color2']
14  
15  // thunks work, too
16  ADD_COLORS (...colors) {
17    return dispatch => colors.forEach(color => dispatch(this.addColor(color)))
18  }
19})
20
21// all keys from above spec will be added directly to your actions object
22actions.DISPLAY_COLORS
23// => 'DISPLAY_COLORS'
24
25// all creators in camelCase form that can be dispatched are added too
26typeof actions.displayColors
27// => 'function'
28
29// all types are also grouped together on the `types` field
30// (the values are identical)
31actions.types.DISPLAY_COLORS
32// => 'DISPLAY_COLORS'
33
34// likewise, all action creators are available through the creators key
35import { bindActionCreators } from 'redux'
36
37const mapDispatchToProps = dispatch => {
38  bindActionCreators(actions.creators, dispatch)
39}

License

MIT