reactjs / reactjs/react.dev

Proposal to change state hook documentation

未关闭
#4,572 0 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

主要语言
JavaScript
星标
11.8k
派生
7.9k
平均合并
1 天 11 小时
30 天内合并 PR
11

描述

The current documentation for setting state hooks is shown as:

<button onClick={() => setCount(count + 1)}>

However wouldn't it be much better to use the previous state?

<button onClick={() => setCount(prevCount => prevCount + 1)}>

This would be more consistent with the original setState documentation.

I have also personally had issues with states being handled incorrectly due to using the documented method of setting state with the rendered state.

Wouldn't this prevent a lot of logical errors people may face due to the documentation?

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

从链接的 Hooks 入门文档开始,并将其中的状态设置示例与链接的原始 setState 文档进行比较。更新示例或随附的指导,以说明函数式更新并与现有文档保持一致;完成的标准是修订后的示例能够清晰传达预期的状态更新模式。

由索引模型根据 Issue 内容生成。

评估

技术栈
javascript, react
领域
documentation
Issue 类型
文档
难度
2/5
预计耗时
1-3 小时
活跃度
停滞
描述清晰度
描述清楚
新手友好度
55/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。