reactjs / reactjs/react.dev

Update Forwarding Refs documentation to include use of keys

オープン
#1,340 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
JavaScript
スター
11.8k
フォーク
7.9k
平均マージ
1日 11時間
マージ済み PR(30日)
11

説明

It's common practice in React to add keys to elements that are being iterated.
After looking carefully at the docs for forwardRef, and running into an issue with a key not being set, it appears that forwardRef returns an iterator, and requires a unique key is set on each element.
It would be great to have the docs for forwardRef reflect this requirement, and note anything unique e.g. common patterns to use when iterating to produce childComponents, which utilize forwardRef.

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

リンク先のページにある forwardRef のドキュメントを確認し、コンポーネントライブラリのメンテナー向けの注記と、子コンポーネントを反復処理する際に報告されている動作に重点を置いてください。関連するガイダンスと一般的な反復処理パターンでページを更新する前に、重要な要件を確認してください。完了の条件は、ドキュメントでこれらの要素に keys がどのように適用されるかを明確に説明していることです。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
javascript, react
領域
documentation
issue の種類
ドキュメント
難易度
2/5
見積もり時間
1〜3時間
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
45/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。