Redux Toolkit 快速开始 ​

介绍 ​

欢迎来到 Redux Toolkit 快速开始教程 ! 本教程会向你简要介绍 Redux Tookit 并且教你如何开始正确使用它。

如何阅读该教程 ​

本页将聚焦于如何通过 Redux Toolkit 以及你将使用到的主要 APIs 来设置 Redux 应用。了解 Redux 是什么，它是如何工作的以及如何使用 Redux Toolkit 的完整示例的说明，请参阅“教程索引”页面中链接的教程.

对于本教程，我们假设你将 Redux Toolkit 与 React 一起使用，但你也可以将其与其他 UI 库框架一起使用。 这些示例是基于典型的 Create-React-App 文件夹结构所有应用的代码都在 src 中，但这些模式可以适应你正在使用的任何项目或文件夹设置。

Create-React-App 的 Redux+JS 模版已经配置了相同的项目设置。

使用总结 ​

安装 Redux Toolkit 和 React-Redux ​

添加 Redux Toolkit 和 React-Redux 依赖包到你的项目中：

npm install @reduxjs/toolkit react-redux

创建 Redux Store ​

创建 src/app/store.js 文件。从 Redux Toolkit 引入 configureStore API。我们从创建一个空的 Redux store 开始，并且导出它:

import { configureStore } from "@reduxjs/toolkit";

export default configureStore({
  reducer: {},
});

上面代码创建了 Redux store ，并且自动配置了 Redux DevTools 扩展 ，这样你就可以在开发时调试 store。

为 React 提供 Redux Store ​

创建 store 后，便可以在 React 组件中使用它。 在 src/index.js 中引入我们刚刚创建的 store , 通过 React-Redux 的 <Provider>将 <App> 包裹起来,并将 store 作为 prop 传入。

import React from "react";
import ReactDOM from "react-dom";
import "./index.css";
import App from "./App";
// highlight-start
import store from "./app/store";
import { Provider } from "react-redux";
// highlight-end

ReactDOM.render(
  // highlight-next-line
  <Provider store={store}>
    <App />
  </Provider>,
  document.getElementById("root")
);

创建 Redux State Slice ​

创建 src/features/counter/counterSlice.js 文件。在该文件中从 Redux Toolkit 引入 createSlice API。

创建 slice 需要一个字符串名称来标识切片、一个初始 state 以及一个或多个定义了该如何更新 state 的 reducer 函数。slice 创建后 ，我们可以导出 slice 中生成的 Redux action creators 和 reducer 函数。

Redux 要求我们通过创建数据副本和更新数据副本，来实现不可变地写入所有状态更新。不过 Redux Toolkit createSlice 和 createReducer 在内部使用 Immer 允许我们编写“可变”的更新逻辑，变成正确的不可变更新。

import { createSlice } from "@reduxjs/toolkit";

export const counterSlice = createSlice({
  name: "counter",
  initialState: {
    value: 0,
  },
  reducers: {
    increment: (state) => {
      // Redux Toolkit 允许我们在 reducers 写 "可变" 逻辑。它
      // 并不是真正的改变状态值，因为它使用了 Immer 库
      // 可以检测到“草稿状态“ 的变化并且基于这些变化生产全新的
      // 不可变的状态
      state.value += 1;
    },
    decrement: (state) => {
      state.value -= 1;
    },
    incrementByAmount: (state, action) => {
      state.value += action.payload;
    },
  },
});
// 每个 case reducer 函数会生成对应的 Action creators
export const { increment, decrement, incrementByAmount } = counterSlice.actions;

export default counterSlice.reducer;

将 Slice Reducers 添加到 Store 中 ​

下一步，我们需要从计数切片中引入 reducer 函数，并将它添加到我们的 store 中。通过在 reducer 参数中定义一个字段，我们告诉 store 使用这个 slice reducer 函数来处理对该状态的所有更新。

import { configureStore } from "@reduxjs/toolkit";
// highlight-next-line
import counterReducer from "../features/counter/counterSlice";

export default configureStore({
  reducer: {
    // highlight-next-line
    counter: counterReducer,
  },
});

在 React 组件中使用 Redux 状态和操作 ​

现在我们可以使用 React-Redux 钩子让 React 组件与 Redux store 交互。我们可以使用 useSelector 从 store 中读取数据，使用 useDispatch dispatch actions。创建包含 <Counter> 组件的 src/features/counter/Counter.js 文件，然后将该组件导入 App.js 并在 <App> 中渲染它。

import React from "react";
import { useSelector, useDispatch } from "react-redux";
import { decrement, increment } from "./counterSlice";
import styles from "./Counter.module.css";

export function Counter() {
  const count = useSelector((state) => state.counter.value);
  const dispatch = useDispatch();

  return (
    <div>
      <div>
        <button
          aria-label="Increment value"
          onClick={() => dispatch(increment())}
        >
          Increment
        </button>
        <span>{count}</span>
        <button
          aria-label="Decrement value"
          onClick={() => dispatch(decrement())}
        >
          Decrement
        </button>
      </div>
    </div>
  );
}

现在，每当你点击”递增“和“递减”按钮。

• 会 dispatch 对应的 Redux action 到 store
• 在计数器切片对应的 reducer 中将看到 action 并更新其状态
• <Counter>组件将从 store 中看到新的状态，并使用新数据重新渲染组件

你学到了什么 ​

这是关于如何通过 React 设置和使用 Redux Toolkit 的简要概述。 回顾细节：

完整的计数器应用示例 ​

这里有运行在 CodeSandbox 完整的计数器应用程序

下一步是什么 ​

我们建议阅读 Redux 核心文档中的“Redux 要点”和“Redux 基础知识”教程, 这将使你全面了解 Redux 的工作原理、Redux Toolkit 的作用以及如何正确使用它。