react-redux-aic

Wrapper for redux useSelector that allows automatically initialize component with server data.

Install

Install from the NPM repository using yarn or npm:

yarn add --dev @pbe/react-redux-aic

npm install -D @pbe/react-redux-aic

Motivation

In most projects, data requests are made from the nearest common component, but when you need to reuse a component, you have to look for its dependencies in order to repeat the initialization behavior on another page or view. This library is designed to solve this problem.

Solution

To solve this problem, it was decided to make a hook that would link data and requests, so that when rendering the component tree, we knew about all the requests needed to initialize the component tree.

API

• AicProvider
• Hooks
  • useAicSelector
  • useAicThunkSelector

AicProvider

AicProvider works on the client side, calls a callback, must be located at the root of the component tree.

<Provider store={store}>
  <AicProvider>
    {children}
  </AicProvider>
</Provider>

Hooks

useAicSelector

Allows you to automatically request data and subscribe to it.

const value = useAicSelector(selector, triggerSelector, callback, callbackParams);

• selector - selector for redux useSelector;
• triggerSelector - If triggerSelector returned undefined when mounting the component, a callback will be called;
• callback - functions that take the first argument of the callbackParam object, required for asynchronous requests to the north and update the redux store;
• callbackParams - an object passed to callback as the first argument

useAicThunkSelector

Same as useAicSelector but with thunk instead of callback.

const value = useAicThunkSelector(selector, triggerSelector, thunk, thunkParams);

Example

import React from 'react';
import ReactDOM from 'react-dom';
import { applyMiddleware, createStore } from 'redux';
import { Provider } from 'react-redux';
import { AicProvider, useAicThunkSelector } from '@pbe/react-redux-aic';
import thunk from 'redux-thunk';

const reducer = (state = {}, action) => ({ ...state, ...action.state });
const store = createStore(reducer, applyMiddleware(thunk));

const getPost = ({ postId }) => {
  return async (dispatch) => {
    const post = await fetch(`/api/post/${postId}.json`).then((res) =>
      res.json()
    );
    dispatch({ type: '', state: { post } });
  };
};

const usePostSelector = (field, postId) => {
  return useAicThunkSelector(
    (state) => state.post && state.post[field],
    (state) => state.post,
    getPost,
    { postId }
  );
};

const PostTitle = () => {
  const postId = 123;
  const title = usePostSelector('title', postId);
  const author = usePostSelector('author', postId);

  if (title === undefined) {
    return <p>Loading...</p>;
  }

  return (
    <div>
      <h1>Post: {title}</h1>
      <strong>Author: {author}</strong>
    </div>
  );
};

const rootElement = document.getElementById("root");
ReactDOM.render(
  <Provider store={store}>
    <AicProvider>
      <PostTitle />
    </AicProvider>
  </Provider>,
  rootElement
);

Dependencies

react, redux, react-redux