reactjs/react.dev

Mention that `Component.render` could return iterator

Open

#286 aberto em 14 de nov. de 2017

Ver no GitHub
 (5 comments) (0 reactions) (0 assignees)JavaScript (7.898 forks)github user discovery
difficulty: mediumgood first issuetype: documentation

Métricas do repositório

Stars
 (11.763 stars)
Métricas de merge de PR
 (Mesclagem média 37d 15h) (21 fundiu PRs em 30d)

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

Guia do colaborador

Direção de pesquisa
Analise a discussão no issue do React vinculado para entender o comportamento de iteradores vs iteráveis, em seguida, atualize a documentação do React.Component para mencionar que o render pode retornar um iterador, mas funciona apenas em produção, e sugira usar um iterável para ambos os ambientes.
Pilha de tecnologia
javascriptreact
Domain
documentation
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
1
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Menos de 1 hora
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
React
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
90