第三节:数据流基础

你将学

  • 如何使用 createSlice 将 reducer 逻辑的“切片”添加到 Redux store
  • 使用 useSelector 钩子(hooks)读取组件中的 Redux 数据
  • 使用 useDispatch 钩子在组件中 dispatch action

info 必备能力

  • 熟悉 Redux 核心术语与概念,如 “actions”、”reducers”、”store”、”dispatching”。(参考 第一节:Redux 概述和概念 有这些术语的介绍)

简介

第一节:Redux 概述和概念 中,我们研究了 Redux 如何通过为我们提供一个放置全局应用状态的单一中心位置来帮助我们构建可维护的应用程序。我们还讨论了核心 Redux 概念,例如 dispatch action 对象、使用返回新状态值的 reducer 函数以及使用 thunk 编写异步逻辑。在 第二节:Redux 应用程序结构 中,我们看到了像 Redux Toolkit 中的 configureStorecreateSlice 以及 React-Redux 中的 ProvideruseSelector 这样的 API 共同努力让我们编写 Redux 逻辑并从我们的 React 组件中与该逻辑进行交互。

既然您对这些部分是什么有了一些了解,现在是时候将这些知识付诸实践了。我们将开发一个小型社交媒体信息流应用,其中将包含许多演示一些真实用例的功能。这将帮助您了解如何在您自己的应用程序中使用 Redux。

注意 本示例应用程序并不是一个完整的生产就绪项目。目标是帮助您学习 Redux API 和典型的使用模式,并使用一些有限的示例为您指明正确的方向。此外,前面的代码在后面可能会更新用来展示更好的开发方式。请通读整个教程来学习所有概念。

项目启动

在本教程中,我们创建了一个预配置的入门项目,该项目已经设置了 React 和 Redux,包括一些默认样式,以及一个允许我们在我们的应用程序中编写实际 API 请求的假 REST API。 您将使用它作为编写实际应用程序代码的基础。

首先,您可以打开并 fork 这个 CodeSandbox:

您还可以克隆Github上相同的仓库。在克隆之后,您可以使用 npm install 来安装依赖,并使用 npm start 来启动。

如果您想看到我们要构建的最终版本,您可以切换到tutorial-steps分支,或打开 CodeSandbox 中的最终版本

感谢 Tania Rascia, 本节中的例子灵感来源于她的 在 React 中使用 Redux。本节的样式还使用了她的 基本 UI CSS 模版

创建 Redux + React 项目

完成本教程后,你可能希望开始自己的项目。我们建议你使用 Create-React-App 的 Redux 模版 作为创建 React + Redux 项目的快捷方式。它内置了配置好的 Redux Tookit 和 React-Redux,使用您在第一节中看到的相同“计数器”应用程序示例。这使您可以跳转到编写实际应用程序代码,而无需添加 Redux 软件包并设置 store。

如果您想了解有关如何将 Redux 添加到项目的特定详细信息,请参阅此说明:

<DetailedExplanation title="细节说明:为 React 项目添加 Redux">

CRA(Create-React-App)的Redux模板附带 Redux Toolkit 并已配置 React-Redux。如果您在没有该模板的情况下从头开始设置新项目,请按照下列步骤操作:

  • 添加 @reduxjs/toolkitreact-redux packages
  • 使 用RTK 的 configureStore API 创建 Redux store,并传入至少一个 reducer 函数。
  • 在应用程序的入口文件(比如 src/index.js)中引入 Redux store。
  • 用 react-redux 中的 <Provider> 组件来包裹 React 根组件,比如
  1. ReactDOM.render(
  2. <Provider store={store}>
  3. <App />
  4. </Provider>,
  5. document.getElementById('root')
  6. )

探索初始项目

让我们快速查看初始项目包含的内容:

  • /src
    • index.js: 应用程序的入口点文件,渲染 React-Redux 的 <Provider>组件和入口组件 <app>
    • App.js: 应用的入口组件。渲染顶部导航条和处理客户端路由。
    • index.css: 应用所有的样式
    • /api
      • client.js: 小的 AJAX 请求客户端,用来发起 GET 和 POST 请求。
      • server.js: 为我们的数据提供假的 REST API。我们的应用程序将在稍后从这些假接口获取数据。
    • /app
      • Navbar.js: 渲染顶部标题和导航
      • store.js: 创建 Redux store 实例

如果您现在加载应用程序,您应该会看到标题和欢迎消息。我们还可以打开 Redux DevTools Extension,看到我们的初始 Redux 状态完全为空。

有了这个,让我们开始吧!

主页的帖子列表

我们社交媒体提要应用程序的主要功能将是帖子列表。 随着我们的进展,我们将为此功能添加更多部分,但首先,我们的第一个目标是仅在屏幕上显示帖子条目列表。

创建帖子列表切片

第一步是创建一个新的 Redux “切片”,其中将包含我们帖子的数据。一旦我们在 Redux store 中拥有该数据,我们就可以创建 React 组件以在页面上显示该数据。

src 目录下,创建 features 目录,然后在里面创建 posts 目录,并在里面创建 postSlice.js 文件。

我们将使用 Redux Toolkit createSlice 函数来创建一个知道如何处理我们的帖子数据的 reducer 函数。 Reducer 函数需要包含一些初始数据,以便 Redux store 在应用程序启动时加载这些值。

现在,我们将创建一个包含一些假帖子对象的数组,以便我们可以开始添加 UI。

我们将导入 createSlice,定义我们的初始 posts 数组,将其传递给 createSlice,并导出createSlice 为我们生成的 posts reducer 函数:

  1. import { createSlice } from '@reduxjs/toolkit'
  2. const initialState = [
  3. { id: '1', title: 'First Post!', content: 'Hello!' },
  4. { id: '2', title: 'Second Post', content: 'More text' }
  5. ]
  6. const postsSlice = createSlice({
  7. name: 'posts',
  8. initialState,
  9. reducers: {}
  10. })
  11. export default postsSlice.reducer

每次我们创建一个新切片时,我们都需要将它的 reducer 函数添加到我们的 Redux store 中。我们已经创建了一个 Redux store,但现在它里面没有任何数据。 打开 app/store.js,导入 postsReducer 函数,并更新对 configureStore 的调用,以便将 postsReducer 作为名为 posts 的 reducer 字段传递:

  1. import { configureStore } from '@reduxjs/toolkit'
  2. import postsReducer from '../features/posts/postsSlice'
  3. export default configureStore({
  4. reducer: {
  5. posts: postsReducer
  6. }
  7. })

这告诉 Redux 我们希望我们的根部 state 对象内部有一个名为 posts 的字段,并且 state.posts 的所有数据都将在 dispatch action 时由 postsReducer 函数更新。

我们可以通过打开 Redux DevTools Extension 并查看当前状态内容来确认这是否有效:

初始的帖子数据

展示帖子列表

现在我们的商店中有一些帖子数据,我们可以创建一个显示帖子列表的 React 组件。 所有与我们的提要帖子功能相关的代码都应该放在 posts 文件夹中,所以继续在那里创建一个名为 PostsList.js 的新文件。

如果我们要呈现一个帖子列表,我们需要从某个地方获取数据。React 组件可以使用 React-Redux 库中的 useSelector 钩子从 Redux store 中读取数据。您编写的“selector 函数”将使用整个 Redux state 对象作为参数被调用,并且应该从 store 中返回该组件需要的特定数据。

我们最初的 PostsList 组件将从 Redux store 中读取 state.posts 值,然后遍历帖子数组并在屏幕上显示每个帖子:

  1. import React from 'react'
  2. import { useSelector } from 'react-redux'
  3. export const PostsList = () => {
  4. const posts = useSelector(state => state.posts)
  5. const renderedPosts = posts.map(post => (
  6. <article className="post-excerpt" key={post.id}>
  7. <h3>{post.title}</h3>
  8. <p className="post-content">{post.content.substring(0, 100)}</p>
  9. </article>
  10. ))
  11. return (
  12. <section className="posts-list">
  13. <h2>Posts</h2>
  14. {renderedPosts}
  15. </section>
  16. )
  17. }

然后我们需要更新 App.js 中的路由,以便我们显示 PostsList 组件而不是“欢迎”消息。将PostsList 组件导入App.js,并将欢迎文本替换为<PostsList />。 我们还将把它包装在一个 React Fragment 中,因为我们很快就会向主页添加其他内容:

```jsx title=”App.js” import React from ‘react’ import { BrowserRouter as Router, Switch, Route, Redirect } from ‘react-router-dom’

import { Navbar } from ‘./app/Navbar’

// highlight-next-line import { PostsList } from ‘./features/posts/PostsList’

function App() { return (

( // highlight-start // highlight-end )} />
) }

export default App

  1. 添加后,我们应用程序的主页现在应如下所示:
  2. ![初始帖子列表](/uploads/projects/redux-chinese-guide/docs/tutorials/essentials/img/tutorials/essentials/working_post_list.png)
  3. 进步! 我们已经向 Redux store 添加了一些数据,并在 React 组件的屏幕上显示它。
  4. ### 添加新帖子
  5. 很高兴看到人们写的帖子,但我们希望能够编写自己的帖子。让我们创建一个“添加新帖子”表单,让我们可以编写帖子并保存它们。
  6. 我们将首先创建空表单并将其添加到页面中。 然后,我们会将表单连接到我们的 Redux store,以便在我们单击“保存帖子”按钮时添加新帖子。
  7. #### 添加新帖子的表单Form
  8. 在我们的 `posts` 文件夹中创建 `AddPostForm.js`。我们将为帖子标题添加一个文本输入,并为帖子正文添加一个文本区域:
  9. ```jsx
  10. import React, { useState } from 'react'
  11. export const AddPostForm = () => {
  12. const [title, setTitle] = useState('')
  13. const [content, setContent] = useState('')
  14. const onTitleChanged = e => setTitle(e.target.value)
  15. const onContentChanged = e => setContent(e.target.value)
  16. return (
  17. <section>
  18. <h2>添加新帖子</h2>
  19. <form>
  20. <label htmlFor="postTitle">帖子标题:</label>
  21. <input
  22. type="text"
  23. id="postTitle"
  24. name="postTitle"
  25. value={title}
  26. onChange={onTitleChanged}
  27. />
  28. <label htmlFor="postContent">内容:</label>
  29. <textarea
  30. id="postContent"
  31. name="postContent"
  32. value={content}
  33. onChange={onContentChanged}
  34. />
  35. <button type="button">保存帖子</button>
  36. </form>
  37. </section>
  38. )
  39. }

将该组件导入App.js,并将其添加到<PostsList /> 组件的正上方:

  1. <Route
  2. exact
  3. path="/"
  4. render={() => (
  5. <React.Fragment>
  6. // highlight-next-line
  7. <AddPostForm />
  8. <PostsList />
  9. </React.Fragment>
  10. )}
  11. />

您应该会看到该表单显示在页眉正下方。

保存帖子

现在,让我们更新我们的帖子切片以向 Redux store 添加新的帖子条目。

我们的帖子切片负责处理帖子数据的所有更新。在 createSlice 调用内部,有一个名为 reducers 的对象。现在,它是空的。我们需要在里面添加一个 reducer 函数来处理添加帖子的情况。

reducers 内部,添加一个名为 postAdded 的函数,它将接收两个参数:当前的 state 值和被调度的 action 对象。由于帖子 postsSlice 知道它负责的数据,所以 state 参数将是 posts 数组本身,而不是整个 Redux 状态对象。

action 对象将我们的新帖子条目作为 action.payload 字段,我们将把新的帖子对象放入 state 数组中。

当我们编写 postAdded reducer 函数时,createSlice 会自动生成一个同名的 “action creator” 函数。我们可以导出该动作创建者并在我们的 UI 组件中使用它来在用户单击“保存帖子”时分派动作。

  1. const postsSlice = createSlice({
  2. name: 'posts',
  3. initialState,
  4. reducers: {
  5. // highlight-start
  6. postAdded(state, action) {
  7. state.push(action.payload)
  8. }
  9. // highlight-end
  10. }
  11. })
  12. // highlight-next-line
  13. export const { postAdded } = postsSlice.actions
  14. export default postsSlice.reducer

caution 警告 请记住:reducer 函数必须总是通过复制来不可变地创建新的状态值! 调用诸如 Array.push() 之类的变异函数或修改 createSlice() 中的诸如 state.someField = someValue 之类的对象字段是安全的,因为它使用 Immer 库在内部将这些突变转换为安全的不可变更新,但不要尝试在 createSlice 之外更改任何数据!

Dispatch “添加帖子” Action

我们的 AddPostForm 有文本输入和 “Save Post” 按钮,但该按钮还没有做任何事情。 我们需要添加一个点击处理程序,它将dispatch postAdded 并传入一个包含用户编写的标题和内容的新帖子对象。

我们的 post 对象也需要有一个 id 字段。现在,我们最初的测试帖子使用了一些假数字作为他们的 ID。 我们可以编写一些代码来确定下一个递增的 ID 编号应该是什么,但是如果我们生成一个随机的唯一 ID 会更好。Redux Toolkit 有一个我们可以使用的 nanoid 函数。

说明 我们将在 第四节:使用 Redux 数据 中详细讨论生成 ID 和 dispatch action。

为了从组件 dispatch action,我们需要访问 store 的 dispatch 函数。我们通过调用 React-Redux 中的 useDispatch 钩子来获得它。我们还需要将 postAdded 动作创建者导入到这个文件中。

一旦我们在组件中使用了 dispatch 函数,我们就可以在点击处理程序中调用 dispatch(postAdded())。 我们可以从我们的 React 组件 useState 钩子中获取标题和内容值,生成一个新的 ID,并将它们放在一个新的 post 对象中,我们将其传递给 postAdded()

  1. import React, { useState } from 'react'
  2. // highlight-start
  3. import { useDispatch } from 'react-redux'
  4. import { nanoid } from '@reduxjs/toolkit'
  5. import { postAdded } from './postsSlice'
  6. // highlight-end
  7. export const AddPostForm = () => {
  8. const [title, setTitle] = useState('')
  9. const [content, setContent] = useState('')
  10. // highlight-next-line
  11. const dispatch = useDispatch()
  12. const onTitleChanged = e => setTitle(e.target.value)
  13. const onContentChanged = e => setContent(e.target.value)
  14. // highlight-start
  15. const onSavePostClicked = () => {
  16. if (title && content) {
  17. dispatch(
  18. postAdded({
  19. id: nanoid(),
  20. title,
  21. content
  22. })
  23. )
  24. setTitle('')
  25. setContent('')
  26. }
  27. }
  28. // highlight-end
  29. return (
  30. <section>
  31. <h2>添加新帖子</h2>
  32. <form>
  33. {/* omit form inputs */}
  34. // highlight-next-line
  35. <button type="button" onClick={onSavePostClicked}>
  36. 保存帖子
  37. </button>
  38. </form>
  39. </section>
  40. )
  41. }

现在,尝试输入标题和一些文本,然后单击“保存帖子”。 您应该会在帖子列表中看到该帖子的新项目。

恭喜!你刚刚构建了你的第一个 React + Redux 应用程序!

这显示了完整的 Redux 数据流周期:

  • 使用 useSelector 从 store 读取初始帖子列表并渲染 UI
  • 我们 dispatch 了包含新帖子条目数据的 postAdded action
  • postsReducer 监听到了 postAdded 动作,并用新条目更新了 posts 数组
  • Redux store 告诉 UI 一些数据已经改变
  • 帖子列表读取更新后的帖子数组,并重新渲染 UI 以显示新帖子

在此之后我们将添加的所有新功能都将遵循相同的这个模式:添加状态切片、编写 reducer 函数、dispatch action 以及基于 Redux store 中的数据渲染 UI。

我们可以检查 Redux DevTools Extension 以查看我们 dispatch 的 action,并查看 Redux 状态如何更新以响应该操作。如果我们单击操作列表中的 posts/postAdded 条目,”Action” 选项卡应如下所示:

postAdded action 信息

“Diff” 选项卡还应该向我们显示 state.posts 添加了一个新项目,位于索引 2。

请注意,我们的 AddPostForm 组件内部有一些 React useState 钩子,用于跟踪用户输入的标题和内容值。记住,Redux store 应该只包含被认为是应用程序“全局”的数据! 在这种情况下,只有 AddPostForm 需要知道输入字段的最新值,因此我们希望将该数据保留在 React 组件状态中,而不是尝试将临时数据保留在 Redux store 中。当用户完成表单时,我们会 dispatch 一个 Redux action,根据用户输入使用最终值更新 store。

你学到了

让我们回顾一下您在本节中学到的内容:

tip 总结

  • Redux state 由 reducer 函数来更新:
    • Reducers 总是通过复制现有状态值,并更新副本来不可变地生成新状态
    • Redux Toolkit createSlice 函数为您生成“slice reducer”函数,并让您编写“mutable 可变”代码,内部自动将其转变为安全的不可变更新
    • 这些切片化 reducer 函数被添加到 configureStore 中的 reducer 字段中,并定义了 Redux store 中的数据和状态字段名称
  • React 组件使用 useSelector 钩子从 store 读取数据
    • 选择器函数接收整个 state 对象,并且返回需要的部分数据
    • 每当 Redux store 更新时,选择器将重新运行,如果它们返回的数据发生更改,则组件将重新渲染
  • React 组件使用 useDispatch 钩子 dispatch action 来更新 store
    • createSlice 将为我们添加到切片的每个 reducer 函数生成 action creator 函数
    • 在组件中调用 dispatch(someActionCreator()) 来 dispatch action
    • Reducers 将运行,检查此 action 是否相关,并在适当时返回新状态
    • 表单输入值等临时数据应保留为 React 组件状态。当用户完成表单时,dispatch 一个 Redux action 来更新 store。

现在应用长这样:

下一步

现在你已经了解 Redux 数据流基础,是时候打开 第 4 节: 使用 Redux 数据,学习给应用添加更多功能并且学习如何与现有 store 中的数据做交互。