reactjs / reactjs/react.dev

Update Forwarding Refs documentation to include use of keys

Offen
#1,340 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
JavaScript
Sterne
11.8k
Forks
7.9k
Ø Merge
1 T. 11 Std.
Gemergte PRs (30 T.)
11

Beschreibung

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.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Überprüfe die forwardRef-Dokumentation auf der verlinkten Seite und konzentriere dich dabei auf den Hinweis für Maintainer von Komponentenbibliotheken sowie das gemeldete Verhalten beim Iterieren über untergeordnete Komponenten. Bestätige die zentrale Anforderung, bevor du die Seite mit den relevanten Hinweisen und gängigen Iterationsmustern aktualisierst; als erledigt gilt die Aufgabe, wenn die Dokumentation klar erklärt, wie keys auf diese Elemente angewendet werden.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
javascript, react
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.