reactjs / reactjs/react.dev

Document Controlled vs Uncontrolled Component Design pattern

Aberta
#918 14 comentários 7 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
JavaScript
Estrelas
11.8k
Forks
7.9k
Merge médio
1d 11h
PRs com merge (30d)
11

Descrição

pursuant to this discussion https://twitter.com/dan_abramov/status/1001943857096003584

all react components can be:

  • controlled (no internal state)
  • uncontrolled (internal state)
  • mixed (uncontrolled by default, unless some props are passed to make it controlled)

the current docs on controlled vs uncontrolled: https://reactjs.org/docs/uncontrolled-components.html focus entirely on forms, but this design pattern applies to -all- components. we should document this.

questions

  1. What else should we say in the docs?
  2. do we want to tell people that they can do "mixed control" or do we leave that for people to discover for themselves?
  3. is this the same page as https://reactjs.org/docs/uncontrolled-components.html or is it a separate page?

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece pela documentação existente de uncontrolled-components.html e pela discussão vinculada. Resolva se os controlled, uncontrolled e mixed component patterns devem pertencer a esta página ou a uma página separada, e determine quais orientações a documentação deve fornecer. O trabalho estará concluído quando a documentação selecionada cobrir claramente o pattern para além de formulários e responder às questões em aberto sobre o escopo.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
react
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
4/5
Tempo estimado
3-5 dias
Status de atividade
Estagnada
Clareza
Precisa de esclarecimento
Facilidade para iniciantes
35/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.