React / 系统课时

设计 reducer 状态

设计 reducer 状态

useReducer 是否清晰,关键不在 switch 写法,而在 state 与 action 的设计。本课通过一个登录流程组织输入、提交状态和错误信息,避免多个布尔值互相冲突,并让每个 action 对应明确事件。

学习目标

  • 用单一状态字段表达互斥阶段
  • 让 action 描述真实事件
  • 避免直接修改旧 state 和保存重复数据

先定义状态约束

登录流程可以处于 editing、submitting、success 或 error。使用一个 status 字段比 isLoading、isSuccess、hasError 三个布尔值更安全,因为后者可能同时为真,产生无法解释的组合。

状态只保存渲染和更新真正需要的数据。能够由现有字段计算出的值不必重复保存,例如按钮是否禁用可由 status === 'submitting' 推导。

主示例:登录 reducer

下面的完整组件使用模拟异步函数验证用户名。reducer 只计算状态,异步调用放在提交处理器中。

jsx
import { useReducer } from 'react';

const initialState = {
  username: '',
  status: 'editing',
  error: null
};

function loginReducer(state, action) {
  switch (action.type) {
    case 'usernameChanged':
      return {
        ...state,
        username: action.value,
        status: 'editing',
        error: null
      };
    case 'submitStarted':
      return { ...state, status: 'submitting', error: null };
    case 'submitSucceeded':
      return { ...state, status: 'success', error: null };
    case 'submitFailed':
      return { ...state, status: 'error', error: action.message };
    default:
      throw new Error(`未知 action:${action.type}`);
  }
}

function fakeLogin(username) {
  return new Promise((resolve, reject) => {
    window.setTimeout(() => {
      username === 'admin'
        ? resolve()
        : reject(new Error('用户名不正确'));
    }, 500);
  });
}

export default function LoginPanel() {
  const [state, dispatch] = useReducer(loginReducer, initialState);

  async function handleSubmit(event) {
    event.preventDefault();
    dispatch({ type: 'submitStarted' });

    try {
      await fakeLogin(state.username);
      dispatch({ type: 'submitSucceeded' });
    } catch (error) {
      dispatch({ type: 'submitFailed', message: error.message });
    }
  }

  const isSubmitting = state.status === 'submitting';

  return (
    <form onSubmit={handleSubmit}>
      <input
        value={state.username}
        disabled={isSubmitting}
        onChange={(event) =>
          dispatch({
            type: 'usernameChanged',
            value: event.target.value
          })
        }
      />
      <button disabled={isSubmitting}>登录</button>
      {state.status === 'success' && <p>登录成功</p>}
      {state.error && <p role="alert">{state.error}</p>}
    </form>
  );
}

预期结果

text
输入 admin 并提交:按钮短暂禁用,随后显示“登录成功”。
输入其他内容并提交:按钮短暂禁用,随后显示“用户名不正确”。
重新编辑用户名时,旧错误被清除并回到 editing 状态。

等待时间约为 500 毫秒,实际调度可能略有差异。

设计 action

action 类型应表达已经发生的事件,而不是“把某字段设为什么”。submitStarted、submitSucceeded 和 submitFailed 能直接对应流程阶段,也便于记录和测试。

action 只携带 reducer 无法自行获得的信息。失败动作需要错误消息,用户名变化动作需要新输入值;成功动作不需要重复携带已有用户名。

保持状态可更新

更新嵌套对象时,应复制发生变化的每一层,不能直接修改旧对象。数组更新使用 map、filter 或展开语法返回新数组。这样 React 才能可靠判断引用变化,也能保留 reducer 的可预测性。

状态结构过深时,先考虑是否可以扁平化,或把独立职责拆成多个 reducer。不要为了“集中管理”把互不相关的页面状态强行塞进一个巨大对象。

验证设计是否合理

可以为 reducer 单独编写输入输出测试:给定确定 state 和 action,断言得到的下一 state。若测试必须模拟网络、时间或 DOM,说明副作用可能被错误地放进了 reducer。

还应检查是否存在不可能状态、重复字段,以及 action 名称是否能表达业务事件。设计良好时,组件渲染逻辑会自然围绕有限状态展开。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计 reducer 状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通