Document Controlled vs Uncontrolled Component Design pattern
Personne n'a encore pris cette issue.
- Langage dominant
- JavaScript
- Étoiles
- 11.8k
- Forks
- 7.9k
- Merge moyen
- 1 j 11 h
- PR mergées (30 j)
- 11
Description
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
- What else should we say in the docs?
- do we want to tell people that they can do "mixed control" or do we leave that for people to discover for themselves?
- is this the same page as https://reactjs.org/docs/uncontrolled-components.html or is it a separate page?
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez par la documentation existante de uncontrolled-components.html et la discussion associée. Déterminez si les controlled, uncontrolled et mixed component patterns doivent figurer sur cette page ou sur une page distincte, et déterminez quelles indications la documentation doit fournir. Le travail est terminé lorsque la documentation retenue couvre clairement le pattern au-delà des formulaires et répond aux questions ouvertes concernant le périmètre.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- react
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Activité
- À l'abandon
- Clarté
- À clarifier
- Accessibilité débutants
- 35/100