redux-modal-manager
v1.0.9
Published
A custom libary base on redux-modal with fix bug when close modal
Downloads
151
Maintainers
Readme
Redux Modal Manager
redux-modal-manager
connect your modal to the redux store, and let you control your modal by simply dispatching actions. This library base on redux-modal
with fix bug when close modal with animation
It works with any react based modal component.
Installation
npm i --save redux-modal-manager
or
yarn add redux-modal-manager
API
connectModal(config)
Connect a modal component to redux store.
Arguments
config
(Object)name
(String)(Require) The modal name.resolve
(Function) Things you want to resolve before show your modal, if return a promise, the modal will show after the promise resolved.getModalState
(Function) A function that takes the entire Redux state and returns the state slice which corresponds to where the redux-modal reducer was mounted. Defaults to assuming that the reducer is mounted under the 'modal' key.
Returns
A React component class that injects modal state, handleHide
action creator into your modal component.
Examples
export default connectModal({ name: 'myModal' })(MyModal)
It will pass the modal state and a handleHide
action creator as props to your modal component.
If you mounted your modal reducer at some other location such as modals
instead of modal
use the getModalState
config
export default connectModal({ name: 'myModal', getModalState: (state) => state.modals })(MyModal)
reducer
The modal reducer. Should be given to mounted to your Redux state at modal
.
Example
import { combineReducers } from 'redux'
import { reducer as modal } from 'redux-modal-manager'
export default combineReducers({
...yourOtherReducers,
modal
})
show(name, props) | show(name, props: T)
The show modal action creator.
Arguments
name
(String) The name of modal to show.props
(Object) Props pass to your modal.
Example
import { show } from 'redux-modal-manager'
import { useDispatch } from 'react-redux'
const dispatch = useDispatch()
dispatch(show('modalName', { prop1: 'example' }))
hide(name)
The hide modal action creator.
Arguments
name
(String) The name of modal to hide.
Example
import { hide } from 'redux-modal-manager'
import { useDispatch } from 'react-redux'
const dispatch = useDispatch()
dispatch(hide('modalName'))
hideAll()
The hide all modal action creator.
Example
import { hideAll } from 'redux-modal-manager'
import { useDispatch } from 'react-redux'
const dispatch = useDispatch()
dispatch(hideAll())
License
MIT