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

[MarianoLazzos]

Hi, i would like to help translating some page!

[carburo]

¡Hola, @MarianoLazzos! Deja un comentario con la página que te interesa traducir para asígnartela.

[MarianoLazzos]

¡Hola, @MarianoLazzos! Deja un comentario con la página que te interesa traducir para asígnartela. Me gustaria traducir: Writing Markup with JSX

[carburo]

@MarianoLazzos ya te lo asigné. Si no has contribuido antes te recomiendo que revises primero la guía de traducción (https://github.com/reactjs/es.reactjs.org/blob/main/TRANSLATION.md), que aunque no está muy completa aborda algunas situaciones comunes. Si tuvieras alguna duda con el proceso, ¡no dudes dejar un comentario!

[MarianoLazzos]

Hola! me gustaria colaborar traduciendo otra pagina, me podrias asignar JavaScript in JSX with Curly Braces ?

[carburo]

@MarianoLazzos ¡Sí, por supuesto!

[tw1ttt3r]

Me gustaría colaborar con Passing Props to a Component

[miguelfdezc]

¡Hola! Me gustaría colaborar traduciendo una página, ¿@carburo me podrías asignar Conditional Rendering? 🙂

[carburo]

@tw1ttt3r @miguelfdezc ya les asigné los artículos

[JeronimoC23]

Hola, como va me gustaria colaborar con Adding Interactivity, gracias!

[carburo]

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

[Oussamaosman02]

Hola, me gustaría ayudar a traducir algún artículo

[carburo]

¡Hola @Oussamaosman02! Gracias por tu interés por contribuir. Escoge uno de los artículos listados y te lo asigno.

[Oussamaosman02]

@carburo ¿Me podrías asignar Rendering Lists?

[carburo]

@Oussamaosman02 ya te lo asigné.

[MigueMartelo]

@carburo hola, podrías asignarme Keeping Components Pure?

[ikurotime]

Hola @carburo, me gustaria traducir Reacting to Input with State ! Y alguno mas después de ese, si se puede 🚀 Si no hay problema, me gustaria traducir Managing State entero.

[MigueMartelo]

@carburo @alejandronanez si se puede tener varias al tiempo, asignadas, me gustaría también tomar `Render and Commit. Gracias.

[samarjaffal]

Hola @carburo a mi también me gustaría apoyar con la traducción de esta página: State: A Component's Memory

[MaximilianoCabreraP]

Hola @carburo que tal? Me gustaria poder ayudar traduciendo esta página: Sharing State Between Components Saludos!

[Waxer59]

Hola @carburo, podrias asignarme State as a Snapshot?

[johansantana]

@carburo, podrías asignarme Responding to Events?

[CamiloCortesM]

hola me gustaría aportar en alguna traducción ¿me podrías asignar alguna?

[carburo]

Hola, @MigueMartelo, @samarjaffal @MaximilianoCabreraP, @Waxer59 @johansantana @CamiloCortesM. Ya les asigné los artículos.

[ikurotime]

Hola, @MigueMartelo, @samarjaffal @MaximilianoCabreraP, @Waxer59 @johansantana @CamiloCortesM. Ya les asigné los artículos.

Hola de nuevo @carburo, como he indicado, también me gustaría contribuir, ¿hay algún motivo por el que no haya sido asignado una sección?

[carburo]

Hola, @ikurotime, disculpa, fue un error de mi parte. Te asigno el artículo que solicitaste.

[diloes]

Buenas. @carburo me haría mucha ilusión contribuir traduciendo la página: Managing State

[carburo]

Hola @diloes. ¡Gracias por tu interés en contribuir! Ya te asigné la página.

[Alanch8]

Buenas @carburo, me gustaría traducir "Queueing a Series of State Updates" si fuese posible. Muchas gracias!

[josavicente]

Hola! @carburo puedes asignarme la traducción de: "Preserving and Resetting State"Gracias! Si está solicitada, puedes asignarme otra :)