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,...);
    ...