Mention that `Component.render` could return iterator

Offen Anfängerfreundlich
#286 6 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

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

Rechercherichtung

Beginnen Sie mit der React Component-Dokumentation im verknüpften Abschnitt react-component.html#fragments und lesen Sie anschließend das verknüpfte React issue sowie die zugehörige Seq-Diskussion zum Verhalten von iterator und iterable. Aktualisieren Sie die Dokumentation so, dass erwähnt wird, dass Component.render einen iterator zurückgeben kann, erklären Sie die Einschränkung, die nur für production gilt, und empfehlen Sie ein iterable für konsistentes Verhalten in beiden Umgebungen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

difficulty: medium good first issue type: documentation

According to the discussion here https://github.com/facebook/react/issues/11502 it is legal to return iterators from Component.render. But it is not mentioned in the document.

Moreover -- it would work only in production mode, not in development. It should me mentioned that to make it work in both environments -- you should use iterable, rather than iterator (see this Seq approach from the Reach issue).

I suggest to place it around https://reactjs.org/docs/react-component.html#fragments

Vorherrschende Sprache
JavaScript
Sterne
11.8k
Forks
7.9k
Ø Merge
16 Std. 6 Min.
Gemergte PRs (30 T.)
7

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus reactjs/react.dev

Alle Issues in reactjs/react.dev

Neue Issues direkt in Ihr Postfach

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