reactjs/react.dev

Mention that `Component.render` could return iterator

Open

#286 ouverte le 14 nov. 2017

Voir sur GitHub
 (5 commentaires) (0 réactions) (0 assignés)JavaScript (7 898 forks)github user discovery
difficulty: mediumgood first issuetype: documentation

Métriques du dépôt

Stars
 (11 763 stars)
Métriques de merge PR
 (Merge moyen 37j 15h) (21 PRs mergées en 30 j)

Description

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

Guide contributeur

Direction de recherche
Examinez la discussion dans le problème React lié pour comprendre le comportement des itérateurs par rapport aux itérables, puis mettez à jour la documentation de React.Component pour mentionner que render peut retourner un itérateur mais ne fonctionne qu'en production, et suggérez d'utiliser un itérable pour les deux environnements.
Stack technique
javascriptreact
Domaine
documentation
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
1
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Moins d'une heure
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
React
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
90