New Translation Progress Checklist

[carburo]

Recientemente se ha publicado la nueva documentación de React:

• New React Docs #3308
• https://react.dev/

Este es el sitio que aloja la traducción: https://es.react.dev

Mantenedores

• @carburo
• @mateoguzmana
• @NGHdeveloper

Para traductores nuevos

Para traducir una página:

1. Chequea que nadie más haya pedido la página en la lista (marcados con🟢) y en los comentarios. Por favor, no crees nuevos issues para solicitar una traducción, mantengámoslo todo aquí.
2. Deja un comentario aquí con el nombre de la página que quieres traducir para evitar duplicar esfuerzo. Toma solo una página a la vez.
3. Por favor, de momento no traduzcas elementos de la UI, aún si se muestren en la página. El equipo de React planea realizar cambios no triviales en el repositorio en los próximos meses, por lo que es mejor concentrarse en la traducción del contenido.
4. Recomendamos usar un corrector ortográfico para minimizar erratas y faltas de ortografía (aquí hay uno que se integra con VSCode).
5. Envía un PR con la traducción parcial o final (preferentemente) en un lapso de 7 (siete) días, a contar desde el momento en que se te es asignada.

Por favor consulta la guía de estilo y el glosario para asegurarnos de que las traducciones se hagan de forma consistente. Si tienes duda con la traducción del algún término que no aparece en el glosario abre un nuevo hilo de debate para aclararlo.

Si luego de asignada la traducción no puedes continuar trabajando en ella deja un comentario para poder asignársela a alguien más. También considera abrir un PR con el trabajo que tengas adelantado y que pueda servir como base para quien tome la traducción.

Main Content

Nuevos artículos

• [x] Understanding Your UI as a Tree
• [x] useFormStatus @luiserdef #918
• [x] React DOM Hooks @materokatti #902
• [x] Built-in React Hooks @Guirdo #914
• [x] useOptimistic @luiserdef #896
• [x] experimental_taintUniqueValue @stivenm16 #923

Learn React

• [x] Quick Start @carburo #507

  • [x] Tutorial: Tic-Tac-Toe @Radapls #629
  • [x] Thinking in React @carburo #506

• [x] Installation @carburo #508

  • [x] Start a New React Project @Radapls #679
  • [x] Add React to an Existing Project @breadadams #665
  • [x] Editor Setup @carburo #512
  • [x] Using TypeScript @s0alken #872
  • [x] React Developer Tools @carburo #513

• [x] Describing the UI @carburo #514

  • [x] Your First Component @carburo #516
  • [x] Importing and Exporting Components @carburo #541
  • [x] Writing Markup with JSX @MarianoLazzos #517
  • [x] JavaScript in JSX with Curly Braces @MarianoLazzos #523
  • [x] Passing Props to a Component @s0alken #703
  • [x] Conditional Rendering @miguelfdezc #542
  • [x] Rendering Lists @Oussamaosman02 #551
  • [x] Keeping Components Pure @MigueMartelo #558

• [x] Adding Interactivity @joelnbl #698

  • [x] Responding to Events @johansantana #552
  • [x] State: A Component's Memory @samarjaffal #586
  • [x] Render and Commit @CamiloCortesM #550
  • [x] State as a Snapshot @Waxer59 #549
  • [x] Queueing a Series of State Updates @Alanch8 #556
  • [x] Updating Objects in State @Alanch8 #563
  • [x] Updating Arrays in State @Nicolas-alt #557

• [x] Managing State @diloes #555

  • [x] Reacting to Input with State @ikurotime #612
  • [x] Choosing the State Structure @Radapls #608
  • [x] Sharing State Between Components @Claudio182 #605
  • [x] Preserving and Resetting State @josavicente #553
  • [x] Extracting State Logic into a Reducer @sunteago #554
  • [x] Passing Data Deeply with Context @merojosa #689
  • [x] Scaling Up with Reducer and Context @josavicente #578

• [x] Escape Hatches @Juamez #669

  • [x] Referencing Values with Refs @johansantana #559
  • [x] Manipulating the DOM with Refs @luiserdef #816
  • [x] Synchronizing with Effects @NahuelDev #673
  • [x] You Might Not Need an Effect @Vicenciomf1 #841
  • [x] Lifecycle of Reactive Effects @meiyerDev #708
  • [x] Separating Events from Effects @danmondra #748
  • [x] Removing Effect Dependencies @carburo
  • [x] Reusing Logic with Custom Hooks @andresguanov #601

API Reference

• [x] react: Hooks @Dazzae-exe #663

  • [x] use @luiserdef #894
  • [x] useCallback @glovooker #594
  • [x] useContext @johansantana #566
  • [x] useDebugValue @luiserdef #609
  • [x] useDeferredValue @jottaxwds #826
  • [x] useEffect @DANIELSSF #590
  • [x] useId @Isaias077 #575
  • [x] useImperativeHandle @luiserdef #620
  • [x] useInsertionEffect @carlos-garcia-dev #642
  • [x] useLayoutEffect @luiserdef #626
  • [x] useMemo @Nicolas-alt #593
  • [x] useReducer @juancguana #651
  • [x] useRef @CamiloCortesM #583
  • [x] useState @Valtory #604
  • [x] useSyncExternalStore @javierlopezdeancos #613
  • [x] useTransition @GalindoSV #682

• [x] react: Components @mateoguzmana #661

  • [x] <Fragment> (<>) @Waxer59 #564
  • [x] <Profiler> @RubenChirino #633
  • [x] <StrictMode> @Dazzae-exe #656
  • [x] <Suspense> @josavicente #581

• [x] react: APIs @mateoguzmana #662

  • [ ] cache @danmondra
  • [x] createContext @Nicolas-alt #562
  • [x] forwardRef @Alanch8 #574
  • [x] lazy @MigueMartelo #591
  • [x] memo @johansantana #579
  • [x] startTransition @RubenChirino #631

• [x] react: Directives @NGHdeveloper #846

  • [x] use client @NahuelDev #835
  • [x] use server @danmondra #842

• [x] react-dom: Components @derrysucari #709

  • [x] Common (e.g. <div>) @alejsdev #685
  • [x] <input> @Guirdo #641
  • [x] <option> @Radapls #648
  • [x] <progress> @RubenChirino #637
  • [x] <select> @carlos-garcia-dev #647
  • [x] <textarea> @manuelrodgzz #636

• [x] react-dom: APIs @s0alken #664

  • [x] createPortal @s0alken #674 ~#619~
  • [x] findDOMNode @RubenChirino #627
  • [x] flushSync @Germancitoz #587
  • [x] hydrate @DANIELSSF #589
  • [x] render @fabianchoxD #561
  • [x] unmountComponentAtNode @Waxer59 #700

• [x] react-dom/client @merojosa #666

  • [x] createRoot @OmiCoding #592
  • [x] hydrateRoot @CamiloCortesM #584

• [x] react-dom/server @cosmoart #713

  • [x] renderToNodeStream @cosmoart #646
  • [x] renderToPipeableStream @MaxDecapitars #677
  • [x] renderToReadableStream @mikelmiras #670
  • [x] renderToStaticMarkup @NGHdeveloper #856
  • [x] renderToStaticNodeStream @luiserdef #696
  • [x] renderToString @RubenChirino #644

Navegación y UI

Sugerimos dejar la mayor parte de la traducción de la UI para el final. Tenemos previsto realizar algunos cambios invasivos en el diseño de las carpetas y los componentes del sitio web, por lo que posponerlo hasta que la traducción esté casi terminada facilitará la integración posterior de los cambios por nuestra parte. Podría tener sentido traducir la página de inicio en primer lugar, pero dejar el resto para más adelante. A medida que se traduzcan las páginas individuales, puede cambiar los títulos de las páginas en los archivos correspondientes de la barra lateral. Por último, cuando traduzcas la navegación, asegúrate de probar tanto el diseño de escritorio como el de móvil.

• [x] Homepage (actualmente en HomeContent.js) @carburo
• [x] Sidebars (actualmente en src/sidebar*.json) @carburo
• [x] Top-level navigation (actualmente en TopNav.tsx) @carburo

Cuando estés listo...

Cuando todo lo anterior esté traducido, añade tu idioma a deployedLanguages en Seo.tsx del repositorio original reactjs/react.dev.

Contenido secundario

Lo ideal sería traducir también estas páginas de la API, pero son menos urgentes y pueden hacerse después de las otras:

• [x] react: Legacy APIs @mateoguzmana #660
  • [x] Children @jonarroh #595
  • [x] cloneElement @bcentdev #597
  • [x] Component @zeuspsy0x1 #668
  • [x] createElement @MigueMartelo #577
  • [x] createFactory @Alanch8 #573
  • [x] createRef @andresguanov #687
  • [x] isValidElement @cjosue15 #576
  • [x] PureComponent @Radapls #610

Contenido opcional

Estos no son los principales objetivos de traducción, pero si deseas hacerlo, no dudes en ampliar la lista para incluir sus subpáginas:

• [x] React Community @AFBGDeveloper #690
  • [x] Acknowledgements @derrysucari #680
  • [x] Docs Contributors @lucasangelino #676
  • [x] React Meetups @ilichpadilla #691
  • [x] Meet the Team @Radapls #759
  • [x] Versioning Policy @derrysucari #707
  • [x] React Videos @AFBGDeveloper #697
• [ ] Blog @NGHdeveloper (No traducir los fragmentos de las publicaciones (BlogCard) si las propias publicaciones no han sido traducidas aún)
  • [x] react-canaries @Juamez #762
  • [ ] react-labs-what-we-have-been-working-on-march-2023 @JaimeTR
  • [x] react-labs-what-we-have-been-working-on-june-2022 @lilymartinez #865
  • [x] react-v18 @vazqueztomas #705
  • [x] react-18-upgrade-guide @iMartinDav #701
  • [x] react-conf-2021-recap @nghsoftware #742
• [x] Warnings
  • [x] Invalid ARIA Prop Warning @Radapls #688
  • [x] Rules of Hooks @s0alken #693
  • [x] Special Props Warning @s0alken #694
  • [x] Unknown Prop Warning @zavbala #744

[johansantana]

Hola @carburo, ¿podrías asignarme también "Referencing Values with Refs"?

[carburo]

@Nicolas-alt, @johansantana ya les asigné las páginas.

[MigueMartelo]

Hola @carburo por fa, puedes asignarme createElement?

[Thxmxs]

Hola @carburo ¿ me podrías asignar "Manipulating the DOM with Refs" ?

[carburo]

@MigueMartelo, @Thxmxs ya les asigné las páginas.

[Waxer59]

Hola @carburo podrias asignarme "Fragment"?

[johansantana]

@carburo me podrías asignar "useContext"?

[carburo]

@Waxer59, @johansantana ya les asigné las páginas.

[fabianchoxD]

Hola @carburo me podrías por favor asignar reeact-dom/render.

Muchas gracias

[carburo]

Hola @fabianchoxD. Ya te lo asigné

[Alanch8]

Hola @carburo, ¿Podrías asignarme algúna página más mientras se aprueba la PR de mis traducciones anteriores? Muchas gracias!

[carburo]

Hola @Alanch8. Te asigné «createFactory». Si prefieres otra en lugar de esa, házmelo saber.

[CamiloCortesM]

Hola ¿me puedes asignar UseRef?

[DANIELSSF]

Hola, ¿Me puedes asignar el useEffect?

[carburo]

@CamiloCortesM, @DANIELSSF ya les asigné las páginas

[Alanch8]

Hola @carburo, ¿Podrías asignarme algúna página más mientras se aprueba la PR de mis traducciones anteriores? Muchas gracias!

[carburo]

Hola @Alanch8. Te asigné «forwardRef»

[Isaias077]

Hola @carburo, ¿Me puedes asignar la página de «useId»?

[carburo]

¡Hola @Isaias077! Ya te asigné el artículo.

[ederivc]

¡Hola! @carburo , ¿Podrías asignarme la página de useReducer?

[carburo]

¡Hola @ederivc! Ya te la he asignado.

[OmiCoding]

¡Hola! @carburo , ¿Podrías asignarme la página de createRoot? Yo, @Asalz20, y @20jasper vamos a traducir la página juntos.

[carburo]

Hola @OmiCoding. Ya la tienes asignada.

[cjosue15]

Hola @carburo, me gustaría colaborar con la traducción de "isValidElement" en la sección de APIs de React.

[carburo]

Hola @cjosue15. Ya te lo asigné.

[01001110J]

Hola @carburo ¿Podría continuar con "useMemo"?

[carburo]

@Nicolas-alt Sí, por supuesto, ya te lo he asignado.

[johansantana]

@carburo Me podrías asignar "memo"?

[carburo]

@johansantana Ya te asigné la página.

[Feli87]

@carburo Hola me podrían asignar "Synchronizing with Effects", saludos.

[MigueMartelo]

@carburo porfa asígname lazy

[josavicente]

Hola @carburo Puedes asignarme la página Suspense de la sección API? Gracias!

[Vicenciomf1]

Hola @carburo! Podrías asignarme "You Might Not Need an Effect" por favor? Ten una buena semana!

[carburo]

@Feli87, @MigueMartelo, @josavicente, @Vicenciomf1 ya tienen asignadas las páginas que solicitaron.

[Vicenciomf1]

Gracias @carburo!

[cjosue15]

@carburo algo mas en lo que pueda ayudar?

[CamiloCortesM]

hola carburo te puedo ayudar con hydrateRoot, ¿me lo puedes asignar?

[DANIELSSF]

Hola @carburo me puedes asignar hydrate

[CamiloCortesM]

@carburo ¿si me puedes asignar hydrateRoot?

[carburo]

@DANIELSSF, @CamiloCortesM ya tienen asignados los artículos.

[carburo]

@cjosue15 Sí, aún quedan artículos por traducir. Además, se puede hacer revisiones de los PRs abiertos, porque aunque solo los maintainers tienen la decisión final de mezclar un PR, las revisiones preliminares pueden ayudar a mejorar la traducción antes de que se haga la revisión final.

[germanfndez]

Hola. me gustaria colaborar con la seccion de flushSync.

[carburo]

Hola @Germancitoz ya tienes asignada la página.

[glovooker]

Hola @carburo me gustaría colaborar con el useCallback

[W00DS0UL]

Hola @carburo me gustaría colaborar con el Separating Events from Effects

[Saturnxs]

Hola @carburo ! Me gustaría colaborar con useImperativeHandle

[carburo]

@glovooker, @W00DS0UL, @Saturnxs ya tienen las páginas asignadas.

[jonarroh]

Hola @carburo me gustaría colaborar con Children me puedes agregar?

[carburo]

¡Hola, @jonarroh! Ya te lo he asignado.

[andresguanov]

Hola, @carburo. Me gustaría colaborar con Reusing Logic with Custom Hooks.