React/ReactNative 状态管理: redux-toolkit 如何使用

2023-03-27 09:04:52 浏览数 (3)

有同学反馈开发 ReactNative 应用时状态管理不是很明白,接下来几篇文章我们来对比下 React 及 ReactNative 状态管理常用的几种框架的使用和优缺点。

上一篇文章介绍了 redux 的使用,这篇文章我们来看下 redux 的升级版:redux-toolkit。

下面是使用 React 和 Redux-Toolkit 创建一个简单的 Todo List App 的代码示例,完整代码见文章末尾:

  1. 首先,在命令行中输入以下命令新建一个React应用:
代码语言:javascript复制
npx create-react-app todolist
  1. 安装 Redux-Toolkit 和 React-Redux:
代码语言:javascript复制
npm install @reduxjs/toolkit react-redux
  1. 创建一个 todoSlice.ts 文件,在其中完成 action 和 reducer的创建「非常重要,需要保证理解」
代码语言:javascript复制
import { createSlice, PayloadAction } from "@reduxjs/toolkit";
import { State, TODO } from "../module/todo";

const initState : State = {
    todos: [
        {
            text: "zsx clean room"
        }
    ]
};

//1.创建 Slice,每个业务一个 分片
const todoSlice = createSlice({
    name: 'todo',   // 这个名称似乎没啥用
    initialState: initState,
    //最重要的 reducers 属性,包括多个函数
    reducers: {
        addTodo: (state: State, action: PayloadAction<string>) => {
            return {
                todos: [...state.todos, {text: action.payload}]
            };
        },
        deleteTodo: (state: State, action: PayloadAction<string>) => {
            state.todos = state.todos.filter((item: TODO, index: number)=> {
                return item.text !== action.payload
            });
        }
    }
})

//2.导出 slice 的 action 和 reducer
export const {addTodo, deleteTodo} = todoSlice.actions;
export default todoSlice.reducer;

在上面的代码里,我们使用 redux-toolkit 的 createSlice 创建了一个分片,分片代表某个业务的数据状态处理,比如 todoSlice 就代表 todo 业务的所有状态处理。

createSlice 的参数,分别包括 name(名称,似乎没啥用)、initialState(项目初始状态)和 reducers,

其中 reducers 是最重要的,它就是一个对象:

代码语言:javascript复制
    reducers: {
        addTodo: (...) => {
          //...
        },
        deleteTodo: (...) => {
          //...
        }
    }

对象的成员就是支持的 action 函数,比如添加 todo:

代码语言:javascript复制
        addTodo: (state: State, action: PayloadAction<string>) => {
            //可以直接修改数据
            // state.todos.push({
            //     text: action.payload
            // })
          
            //也可以返回新的
            return {
                todos: [...state.todos, {text: action.payload}]
            };
        }

可以看到,上面的 addTodo 类似 redux 中的 reducer,不同的在于,createSlice 中不再需要根据 action type 进行 switch case 匹配,而是直接提供了函数,以执行状态。

需要注意的是,toolkit 中的 reducer 函数,可以修改原始状态(redux 本身是需要返回新状态的),这是因为它内部的特殊实现。

  1. 通过 createSlice 创建完 todoSlice 后,下一步就是导出其中的 action 和 reducer
代码语言:javascript复制
export const {addTodo, deleteTodo} = todoSlice.actions;
export default todoSlice.reducer;

这里再次证明,slice 是 action 和 reducer 的封装,redux-toolkit 通过 slice 把 action 和 reducer 封装到了一起,不再需要单独创建 action 和 action creator。

通过 redux-toolkit,我们创建完 slice,就可以通过 slice 的 action 和 reducer 进行使用。

  1. 创建 store:
代码语言:javascript复制
import { configureStore } from "@reduxjs/toolkit";
import todoReducer from "./todoSlice";

//3.配置 store,创建全局唯一的 stroe
const store = configureStore({
    //多个 reducer,访问数据时也需要通过多层获取
    //这里的名称,决定了获取数据时,需要访问的对象名称
    reducer: {
        todo: todoReducer
    }
});

export default store;

和 redux 不同,redux-toolkit 使用 configureStore 创建 store,它的好处是当有多个 reducer 时更简单。

只需要在参数里提供一个 reducer 对象即可,有多少个业务,就给这个对象增加几个成员。

代码语言:javascript复制
{
    //多个 reducer,访问数据时也需要通过多层获取
    //这里的名称,决定了获取数据时,需要访问的对象名称
    reducer: {
        todo: todoReducer,
        other: otherReducer
    }
}

最终业务在访问自己的数据时,通过 对象名称可以获取到数据。

  1. 上层组件通过 Provider 分发给组件树:
代码语言:javascript复制
const root = ReactDOM.createRoot(
  document.getElementById('root') as HTMLElement
);

//分发给子元素
root.render(
  <Provider store={store}>
    <ToolkitTodoApp/>
  </Provider>
);

这一点和 redux 一样,都是使用 react-redux 的 Provider 提供给子组件,参数就是上一步创建的 store。

ToolkitTodoApp 是下一步要创建的 UI 组件

  1. 最后一步,业务组件中通过 useSelector 和 useDispatch 获取数据和分发行为:
代码语言:javascript复制
import {useState} from "react";
import { useDispatch, useSelector } from "react-redux";
import { State, TODO } from "../module/todo";
import store from "./store";
import { addTodo, deleteTodo } from "./todoSlice";
type RootState = ReturnType<typeof store.getState>;

//业务通过 useSelector 获取数据;通过 useDispatch 分发
//比如使用 connect,更简单易懂
const ToolkitTodoApp = () => {

    //获取到的是全局的 State,需要通过 reducer 的名称获取到当前需要的状态
    const todos = useSelector((state: RootState) => {
        return state.todo.todos;
    });

    const dispatch = useDispatch();
    const [text, setText] = useState('');

    const handleInput = (e: any) => {
        setText(e.target.value)
    }

    const handleAddTodo = () => {
        //todoSlice 导出的 action, 参数就是 action.payload 的类型
        dispatch(addTodo(text))
        setText('')
    }

    const handleDeleteTodo = (text: string) => {
        dispatch(deleteTodo(text))
    }

    return (
        <div style={{display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center'}}>
            <h1>This Is Redux-Toolkit TODO App.</h1>
            <ul>
                {todos && todos.map((todo: TODO, index: any) => {
                    return (
                        <li key={index}>
                            <span>{todo.text}</span>
                            <button style={{marginLeft: '12px'}} onClick={() => handleDeleteTodo(todo.text)}>finish</button>
                        </li>
                    )
                })}
            </ul>

            <div style={{display: 'flex', flexDirection: 'row'}}>
                <input value={text} onChange={handleInput}/>
                <button onClick={handleAddTodo}>Add Todo</button>
            </div>
        </div>
    )
}

export default ToolkitTodoApp;

从上面的代码中可以看到,使用 redux-toolkit,组件里获取状态也更简单了,不再需要写 connect、mapStateToProps 和 mapDispatchToProps,只需要通过 react-redux 提供的 useSelector hook 即可:

代码语言:javascript复制
    const todos = useSelector((state: RootState) => {
        return state.todo.todos;
    });

需要注意的是:useSelector 里筛选自己需要的数据时,需要通过 reducer 的名称获取到当前需要的状态,否则会出现字段取不到或者取错的情况。

比如上面的例子里,配置 store 时,todo 的 reducer 的名称叫 “todo”,那在 todo 业务里,通过useSelector 里获取它 state 时,就需要通过这个名称 “todo” 去拿字段:

代码语言:javascript复制
const store = configureStore({
    //多个 reducer,访问数据时也需要通过多层获取
    //这里的名称,决定了获取数据时,需要访问的对象名称
    reducer: {
        todo: todoReducer
    }
});
代码语言:javascript复制
state.todo.todos;

我一开始使用 redux-toolkit 的时候,就在这一步遇到了问题。

另外,使用 useDispatch 分发行为时也需要注意:传递的参数是 createSlice 后导出的 action,参数类型需要和 这个 action 的 payload 类型一样。

比如前面的 todoSlice 的 reducers 里,addTodo 的 action 类型是 PayloadAction:

代码语言:javascript复制
addTodo: (state: State, action: PayloadAction<string>) => {...}

那在调用这个 action 时,就需要传递 string 类型的参数:

代码语言:javascript复制
    const handleAddTodo = () => {
        //todoSlice 导出的 action, 参数就是 action.payload 的类型
        dispatch(addTodo(text))
        setText('')
    }

总结一下,通过 redux-toolkit 管理状态分这几步:

  1. 通过 createSlice 创建 slice,在其中指定初始状态和支持的 action reducer
  2. 导出 slice 的 actions 和 reducer
  3. 通过 configureStore 创建 store,参数是一个对象,包括上一步导出的 reducer
    1. 需要指定好业务名称,后续取数据要用
  4. 通过 Provider 分发给组件树
  5. 业务组件中通过 useSelector 和 useDispatch 获取数据和分发行为

可以看到,redux-toolkit 与 redux 相比,不需要创建 action creator 和 connect,简化了开发步骤。

完整代码:https://github.com/shixinzhang/redux-sample/tree/main/src/redux-toolkit

0 人点赞