reactjs/react.dev

Mention that `Component.render` could return iterator

Open

#286 geöffnet am 14. Nov. 2017

Auf GitHub ansehen
 (5 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)JavaScript (7.898 Forks)github user discovery
difficulty: mediumgood first issuetype: documentation

Repository-Metriken

Stars
 (11.763 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 37T 15h) (21 gemergte PRs in 30 T)

Beschreibung

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

Contributor Guide

Research-Richtung
Überprüfen Sie die Diskussion im verlinkten React Issue, um das Verhalten von Iteratoren und Iterables zu verstehen, und aktualisieren Sie dann die React.Component Dokumentation, um zu erwähnen, dass render einen Iterator zurückgeben kann, aber nur in der Produktion funktioniert, und schlagen Sie die Verwendung eines Iterables für beide Umgebungen vor.
Tech Stack
javascriptreact
Domain
documentation
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
1
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
Unter 1 Stunde
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
React
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
90