fmihel-redux-wrapper
v3.0.1
Published
redux wrapper
Downloads
2
Readme
redux-wrapper
Обертка для библиотеки redux, упрощает начальную инициализацию библиотеки и содержит несколько вспомогательных утилит.
Начало работы / Install
npm i fmihel-redux-wrapper
Структура приложения / Application struct
[APP]
|----[REDUX]
| |----data.js
| |----ReactRedux.js
| |----index.js
|----[ACTION]
| |----action.js
| |----reducer.js
| |----consts.js
| |----index.js
|----index.js
|----App.jsx
APP\REDUX\data.js
const data = {
ui: {
msg: 'text',
},
};
export default data;
APP\REDUX\ReactRedux.js
import { Redux } from 'fmihel-redux-wrapper';
import { connect } from 'react-redux';
export default class ReactRedux extends Redux {
connect(...arg) {
return connect(...arg);
}
}
APP\REDUX\index.js
import Redux from './ReactRedux';
import data from './data';
export default new Redux(data);
APP\ACTION\consts.js
export const TEST = 'TEST';
export const TEST_OK = 'TEST_OK';
export const TEST_ERR = 'TEST_ERR';
APP\ACTION\action.js
import redux from '../REDUX';
import * as consts from './consts';
const doAction = (msg) => (dispatch) => {
dispatch({
type: consts.TEST,
});
setTimeout(()=>{
if (msg){
dispatch({
type: consts.TEST_OK,
payload: msg,
});
}else{
dispatch({
type: consts.TEST_ERR,
payload: 'msg is empty',
});
}
},1000);
};
const action = (msg) => redux.store.dispatch(doAction(msg));
export default action;
APP\ACTION\reducer.js
import redux from '../REDUX';
import * as consts from './consts';
const is = (action) => Object.keys(consts).indexOf(action.type) >= 0;
const reducer = (state, action) => {
if (action.type === consts.TEST) {
return {...state,
ui:{
...state.ui,
msg:action.payload
}
};
}
if (action.type === consts.TEST_OK) {
return {...state,
ui:{
...state.ui,
msg:action.payload
}
};
}
if (action.type === consts.TEST_ERR) {
return {...state,
ui:{
...state.ui,
msg:action.payload
}
};
}
return state;
};
export default { is, reducer };
APP\ACTION\index.js
import redux from '../REDUX';
import reducer from './reducer';
import action from './action';
redux.add(reducer,{myAction:action});
export default action;
APP\App.jsx
import React from 'react';
import redux from './REDUX/';
class App extends React.Component {
constructor(p) {
super(p);
this.onPress = this.onPress.bind(this);
}
onPress() {
redux.actions.myAction('send message');
}
render() {
const { ui } = this.props.reduxData;
return (
<div onClick={this.onPress}>
{ui.msg}
</div>
);
}
}
const mapStateToProps = (state) => ({
reduxData: state,
});
export default redux.connect(mapStateToProps)(App);
APP\index.js
import redux from './REDUX';
import './ACTION/'; // need for register reducer and action
import { Provider } from 'react-redux';
import React from 'react';
import { createRoot } from 'react-dom/client';
import App from './App.jsx';
const dom = document.getElementById('app');
const root = createRoot(dom);
root.render(<Provider store={redux.store}><App /></Provider>);
API
|||
|----|----|
|Redux.add(reducerObject,actionObject)
| добавляет объект редюсер связанный с ним action ( см.описание reducerObject и reducerAction)|
|Redux.add(reducerObject)
| добавляет дополнительный объект редюсер( см.описание reducerObject),который будет вызван после основного описанного в Redux.add(reducerObject,actionObject)|
|Redux.store
|объект store|
|Redux.actions
| коллекция действий, создаваемая с помощью Redux.addAction({aactionName:func})|
|Redux.on(func:Function)
|аналогично store.subscribe|
|||
reducerObject
Обьект должен содержать две ф-ции :
const reducerObject = {
/** ф-ция определяющая принадлежность редюсера к соотвествующему action*/
is(action)=>{
return ...;// bool
},
/** ф-ция редюсера */
reducer(state,action)=>{
....
return state;
}
}
actionObject
Объект содержит ф-цию, по которой можно вызвать соотвествующий диспетчер действия
const actionObject = {
ACTION_NAME(arg1,arg2,...)=> {
redux.store.dispatch(
(arg1,arg2,...)=>{
// действия
}
);
}
}
Вызов действия можно осуществить
...
redux.actions.ACTION_NAME(arg1,arg2,...);
...