reactjs / reactjs/react.dev

[Suggestion]: improve <Form> documentation to explain how to keep form state after submission

Abierto
#8,397 1 comentario 7 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

type: documentation
Lenguaje dominante
JavaScript
Estrellas
11.8k
Forks
7.9k
Merge medio
1 d 11 h
PR fusionados (30 d)
11

Descripción

Summary

https://github.com/facebook/react/issues/29034 raises concerns about actions resetting forms. There are many use cases where developers would want to prevent the form from resetting. Since React's behavior is not expected to change, the docs should explain to users how to control form resets and preserve the form's previous state.

Page

https://react.dev/reference/react-dom/components/form

Details

I do not know the best way to provide this information. Some suggestions include:

  1. Add a deep dive on when to use onSubmit vs action props.
  2. Include an example of opting out of automatic resets using an example based on @eps1lon comment here: https://github.com/facebook/react/issues/29034#issuecomment-2143595195. The issue has several other workarounds that may or may not be endorsed by the Rect team.
  3. Update the Handling multiple submission types example so that the "Save draft" button will keep the text of the form.

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Comienza con la página de referencia de React sobre

, especialmente con el ejemplo “Handling multiple submission types”, y revisa el issue #29034 y el comentario enlazado sobre el comportamiento de reset y las soluciones alternativas propuestas. Se considera terminado cuando la página explique claramente cómo conservar el estado del formulario después del envío e incluya un ejemplo acordado y preciso sin recomendar un comportamiento no compatible.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
javascript, react
Área
documentation
Tipo de issue
Documentación
Dificultad
3/5
Tiempo estimado
1-2 días
Estado de actividad
Tranquilo
Claridad
Bastante claro
Aptitud para principiantes
48/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.