Tradução da documentação para pt-br (Translation Progress)

[eduardomoroni]

A nova documentação do React está no pt-br.react.dev. Já criaram um issue sobre o assunto em reactjs/react.dev#4135 e uma discussão #553

Como contribuir

Revisando Pull Requests

uma maneira de contribuir é revisar algum PR que esteja aberto, conferindo se a tradução faz sentido e é entendível.

Traduzindo

Escolha uma das páginas abaixo que esta disponível (ou seja, ninguém está traduzindo), crie um fork deste repositório, traduza a página no seu fork e manda um Pull request para a comunidade revisar e mergear.

Páginas para serem traduzidas

Por favor faça um comentário para atualizarmos essa tabela a medida que prosseguirmos na tradução, colocaremos o seu nome de usuário(a) do github na frente da página que você pretende traduzir

Conteúdo principal

Para fazer antes de lançar como uma tradução "oficial". Por favor, traduza estas páginas primeiro.

Observe que cada seção possui uma página de índice, que também precisa ser traduzida.

Guia de Estilo Universal

• Leia nosso GLOSSARY

Learn React

• Quick Start (@alexandredev3) Tradução da página Quick Start #754

  • Tutorial: Tic Tac Toe (@TarsiSurdi) docs(pt-br): translated tutorial-tic-tac-toe.md #686
  • Thinking in React (@NivaldoFarias) Translate thinking-in-react.md to pt-br #862

• Installation (@NivaldoFarias) Tradução da página installation.md #661

  • Creating a React App Translate creating-a-react-app.mdand build-a-react-app-from-scratch.md to Portuguese #1087
  • Build a React App from Scratch
  • Add React to an Existing Project (@revogabe) Translate add-react-to-an-existing-project #659
  • Editor Setup (@volinha) docs(pt-br): translate editor-setup page #656
  • Using TypeScript (@rayonnunes) docs(pt-br): translate typescript page #715
  • React Developer Tools (@NivaldoFarias) Tradução de react-developer-tools.md para Português (Brasil) #1204
  • Setup Translate update-arrays-in-state.md, keep-components-pure.md and setup.mdto pt #1103

• React Compiler (Learn)

  • Introduction
  • Installation
  • React Compiler (index) Translate index.md , installation.mdand introdution.md of react compiler #1102
  • Incremental Adoption feat: translate React Compiler incremental adoption page to Portuguese #1099
  • Debugging and Troubleshooting feat: translate React Compiler debugging page to Portugues #1098

• Describing the UI (@natrodrigo) Translation of the describing-the-ui page #660

  • Your First Component (@alexandredev3) Translate your-first-component page #669
  • Importing and Exporting Components (@tiagobarros01) Translate Importing and Exporting Components page #658
  • Writing Markup with JSX (@NivaldoFarias) Translate writing-markup-with-jsx.md to Portuguese #1014
  • JavaScript in JSX with Curly Braces (@roccomaniscalco) Translate javascript-in-jsx-with-curly-braces.md #674
  • Passing Props to a Component (@TarsiSurdi) docs(pt-br): translated passing-props-to-a-component.md #676
  • Conditional Rendering (@VitorGultzgoff) docs(pt-br): translate conditional-rendering #692
  • Rendering Lists (@TarsiSurdi) Translated 'Rendering Lists' page #670
  • Keeping Components Pure Fix translation mistake in effects section of "Keeping Components Pure" #1123
  • Understanding Your UI as a Tree (@NivaldoFarias) Translate understanding-your-ui-as-a-tree.md to Portuguese #1002

• Adding Interactivity Translate adding-interactivity.md to Portuguese #1089

  • Responding to Events (@alexandredev3) Translates responding-to-events page #684
  • State: A Component's Memory (@TarsiSurdi) Translated "State: A Component's Memory" page #671
  • Render and Commit (@tiagobarros01) Translate the render-and-commit page #665
  • State as a Snapshot (@NivaldoFarias) Tradução da página state-as-a-snapshot.md  #690
  • Queueing a Series of State Updates (@NivaldoFarias) Translate queueing-a-series-of-state-updates.md to pt-br #849
  • Updating Objects in State (@Egpereira) Translate updating-objects-in-state.md #679
  • Updating Arrays in State Translate update-arrays-in-state.md, keep-components-pure.md and setup.mdto pt #1103

• Managing State

  • Reacting to Input with State (@vinicius77) fix(reacting-to-input-with-state) #683
  • Choosing the State Structure (@NivaldoFarias) Tradução da página choosing-the-state-structure.md #688
  • Sharing State Between Components (@sergiotcnolivre) Translated "Sharing State Between Components" page #673
  • Preserving and Resetting State — PR aberto Tradução de preserving-and-resetting-state.md para Português (Brasil) #1200
  • Extracting State Logic into a Reducer
  • Passing Data Deeply with Context
  • Scaling Up with Reducer and Context — PR aberto Tradução de scaling-up-with-reducer-and-context.md para Português (Brasil) #1206

• Escape Hatches (@jotaRenan) translate escape-hatches.md to pt-BR #664

  • Referencing Values with Refs (@thelucfer) docs(pt-br): translate 'referencing values with ref' #707
  • Manipulating the DOM with Refs
  • Synchronizing with Effects (@NivaldoFarias) Tradução de synchronizing-with-effects.md para Português (Brasil) #1207
  • You Might Not Need an Effect (@augustodg2) docs(pt-br): Translate you-might-not-need-an-effect.md #675
  • Lifecycle of Reactive Effects
  • Separating Events from Effects — PR aberto Tradução de separating-events-from-effects.md para Português (Brasil) #1208
  • Removing Effect Dependencies (@NivaldoFarias) Tradução de removing-effect-dependencies.md para Português (Brasil) #1205
  • Reusing Logic with Custom Hooks (@Guribeiro) Docs/translate reusing logic with custom hooks #695

Blog

• Blog index — PR aberto Tradução de index.md para Português (Brasil) #1194
• Introducing react.dev (@Lucasfog) docs(pt-br): translate introducing-react-dev page #720
• The Plan for React 18 (@NivaldoFarias) Translate the-plan-for-react-18.md to Portuguese #973
• React v18.0 (@NivaldoFarias) Translate react-v18.md to Portuguese #982
• React 18 Upgrade Guide (@NivaldoFarias) Translate react-18-upgrade-guide.md to Portuguese #980
• React Labs: March 2023 (@NivaldoFarias) Translate react-labs-what-we-have-been-working-on-march-2023.md to Portuguese #979
• React Canaries (@NivaldoFarias) Translate react-canaries.md to Portuguese #974
• React Conf 2021 Recap (@NivaldoFarias) Translate react-conf-2021-recap.md to Portuguese #977
• React Conf 2024 Recap (@NivaldoFarias) Translate react-conf-2024-recap.md to Portuguese #976
• Introducing the React Foundation (@NivaldoFarias) Tradução de introducing-the-react-foundation.md para Português (Brasil) #1190
• Denial of Service and Source Code Exposure in RSC (@NivaldoFarias) Tradução de denial-of-service-and-source-code-exposure-in-react-server-components.md para Português (Brasil) #1193
• Data Fetching with React Server Components (2020)
• React Labs: June 2022
• React Labs: February 2024
• React 19 Upgrade Guide — PR aberto Tradução de react-19-upgrade-guide.md para Português (Brasil) #1182
• React Compiler Beta Release — PR aberto Tradução de react-compiler-beta-release.md para Português (Brasil) #1184
• React v19
• Sunsetting Create React App — PR aberto Tradução de sunsetting-create-react-app.md para Português (Brasil) #1186
• React Labs: View Transitions, Activity, and more
• React 19.2 — PR aberto Tradução de react-19-2.md para Português (Brasil) #1189
• React Compiler v1.0 — PR aberto Tradução de react-compiler-1.md para Português (Brasil) #1188
• React Conf 2025 Recap
• Critical Security Vulnerability in RSC — PR aberto Tradução de critical-security-vulnerability-in-react-server-components.md para Português (Brasil) #1192
• The React Foundation (2026)

API Reference

• react: Hooks (@NivaldoFarias) Translate hooks.md to Portuguese #1055

  • use (@NivaldoFarias) Translate use.md to Portuguese #1063
  • useActionState (@NivaldoFarias) Translate useActionState.md to Portuguese #1062
  • useCallback (@NivaldoFarias) Translate useCallback.md to pt-br #919
  • useContext (@NivaldoFarias) Translate useContext.md to pt-br #920
  • useDebugValue (@NivaldoFarias) Translate useDebugValue.md to pt-br #913
  • useDeferredValue (@NivaldoFarias) Translate useDeferredValue.md to Portuguese #1066
  • useEffect (@NivaldoFarias) Translate useEffect.md to pt-br #930
  • useEffectEvent (@NivaldoFarias) Tradução de useEffectEvent.md para Português (Brasil) #1242
  • useId (@tiagobarros01) Translate the useId page #697
  • useImperativeHandle (@tiagobarros01) docs(pt-br): translate useImperativeHandle page  #727
  • useInsertionEffect
  • useLayoutEffect (@Duduzera1997) docs(pt-br): translation of useLayoutEffect hook 🪝 #718
  • useMemo (@NivaldoFarias) Translate useMemo.md to Portuguese #1069
  • useOptimistic (@NivaldoFarias) Translate useOptimistic.md to Portuguese #1060
  • useReducer
  • useRef (@NivaldoFarias) Translate useRef.md to Portuguese #1065
  • useState (@NivaldoFarias) Translate useState.md to Portuguese #1068
  • useSyncExternalStore (@NivaldoFarias) Translate useSyncExternalStore.md to Portuguese #1064
  • useTransition (@GabrielleEmanoela) docs(pt-br): translate useTransition page.  #722

• react: Components (@vitoroberto) docs(pt-br): translate react-components page #701

  • <Activity> (@NivaldoFarias) Tradução de Activity.md para Português (Brasil) #1237
  • <Fragment> (<>) (@kevinCubas) Translate Fragment.md #680
  • <Profiler> (@alexandredev3) Tradução da Página <Profiler> #758
  • <StrictMode> (@NivaldoFarias) Translate StrictMode.md to Portuguese #1047
  • <Suspense> (@NivaldoFarias) Translate Suspense.md to Portuguese #1048
  • <ViewTransition> (@NivaldoFarias) Tradução de ViewTransition.md para Português (Brasil) #1238

• react: APIs (@devlulcas) docs(pt-br): translate react-apis and createContext page #667

  • act (@NivaldoFarias) Translate act.md to Portuguese #1042
  • addTransitionType (@NivaldoFarias) Tradução de addTransitionType.md para Português (Brasil) #1236
  • cache (@NivaldoFarias) Translate cache.md to Portuguese #1045
  • cacheSignal (@NivaldoFarias) Tradução de cacheSignal.md para Português (Brasil) #1239
  • captureOwnerStack (@NivaldoFarias) Tradução de captureOwnerStack.md para Português (Brasil) #1241
  • createContext (@devlulcas) docs(pt-br): translate react-apis and createContext page #667
  • createElement (@NivaldoFarias) Translate createElement.md to Portuguese #1056
  • forwardRef (@NivaldoFarias) Translate forwardRef.md to Portuguese #1058
  • lazy (@NivaldoFarias) Translate lazy.md to pt-br #915
  • memo (@NivaldoFarias) Translate memo.md to pt-br #918
  • startTransition (@NivaldoFarias) Translate startTransition.md to Portuguese #1061

• react: Legacy APIs (@NivaldoFarias) Translate legacy.md to Portuguese #1051

  • Children (@NivaldoFarias) Translate Children.md to Portuguese #1046
  • cloneElement (@NivaldoFarias) Translate cloneElement.md to Portuguese #1059
  • Component (@NivaldoFarias) Translate Component.md to Portuguese #1049
  • createRef (@NivaldoFarias) Translate createRef.md to Portuguese #1053
  • isValidElement (@NivaldoFarias) Translate isValidElement.md to Portuguese #1052
  • PureComponent (@NivaldoFarias) Translate PureComponent.md to Portuguese #1041
  • experimental_taintObjectReference (@NivaldoFarias) Translate experimental_taintObjectReference.md to Portuguese #1054
  • experimental_taintUniqueValue (@NivaldoFarias) Translate experimental_taintUniqueValue.md to Portuguese #1057
  • experimental_useEffectEvent (@NivaldoFarias) Translate experimental_useEffectEvent.md to Portuguese #1050

• react-dom: Components (@NivaldoFarias) Tradução de index.md para Português (Brasil) #1229

  • Common (e.g. <div>) (@NivaldoFarias) Translate common.md to Portuguese #1020
  • <form> (@NivaldoFarias) Translate form.md to Portuguese #1016
  • <input> (@NivaldoFarias) Translate input.md to Portuguese #1017
  • <link> (@NivaldoFarias) Translate link.md to Portuguese #1015
  • <meta> (@NivaldoFarias) Tradução de meta.md para Português (Brasil) #1231
  • <option> (@NivaldoFarias) Translate option.md to Portuguese #1022
  • <progress> (@felipefreitag) docs(pt-br): translated progress.md #678
  • <script> (@NivaldoFarias) Translate script.md to Portuguese #1026
  • <select> (@enriccogemha) docs(pt-br): translated select.md #794
  • <style> (@NivaldoFarias) Translate style.md to Portuguese #1025
  • <textarea> (@NivaldoFarias) Translate textarea.md to Portuguese #1029
  • <title> (@NivaldoFarias) Translate title.md to Portuguese #1023

• react-dom: APIs (@NivaldoFarias) Tradução de index.md para Português (Brasil) #1232

  • createPortal (@NivaldoFarias) Translate createPortal.md to Portuguese #1028
  • flushSync (@NivaldoFarias) Translate flushSync.md to Portuguese #1024
  • preconnect (@NivaldoFarias) Translate preconnect.md to Portuguese #1030
  • prefetchDNS (@NivaldoFarias) Translate prefetchDNS.md to Portuguese #1033
  • preinit (@NivaldoFarias) Translate preinit.md to Portuguese #1035
  • preinitModule (@NivaldoFarias) Translate preinitModule.md to Portuguese #1034
  • preload (@NivaldoFarias) Translate preload.md to Portuguese #1037
  • preloadModule (@NivaldoFarias) Translate preloadModule.md to Portuguese #1032

• react-dom/client: Client APIs (@NivaldoFarias) Tradução de index.md para Português (Brasil) #1228

  • createRoot (@NivaldoFarias) Translate createRoot.md to Portuguese #1019
  • hydrateRoot

• react-dom/server: Server APIs (@MarceloSpessoto) Translates react-dom/server page. #728

  • renderToPipeableStream (@NivaldoFarias) Translate renderToPipeableStream.md to Portuguese #1038
  • renderToReadableStream (@NivaldoFarias) Translate renderToReadableStream.md to Portuguese #1039
  • renderToStaticMarkup (@NivaldoFarias) Translate renderToStaticMarkup.md to Portuguese #1031
  • renderToString (@NivaldoFarias) Translate renderToString.md to Portuguese #1036
  • resume
  • resumeToPipeableStream (@NivaldoFarias) Tradução de resumeToPipeableStream.md para Português (Brasil) #1235

• react-dom/static: Static APIs (@NivaldoFarias) Translate index.md to Portuguese #1040

  • prerender (@NivaldoFarias) Translate prerender.md to Portuguese #1043
  • prerenderToNodeStream (@NivaldoFarias) Translate prerenderToNodeStream.md to Portuguese #1044
  • resumeAndPrerender (@NivaldoFarias) Tradução de resumeAndPrerender.md para Português (Brasil) #1234
  • resumeAndPrerenderToNodeStream (@NivaldoFarias) Tradução de resumeAndPrerenderToNodeStream.md para Português (Brasil) #1233

• react-dom/hooks (@NivaldoFarias) Translate index.md to Portuguese #1021

  • useFormStatus (@NivaldoFarias) Translate useFormStatus.md to Portuguese #1027

• React Server Components (@NivaldoFarias) Translate directives.md to Portuguese #1070

  • server-components (@NivaldoFarias) Translate server-components.md to Portuguese #1074
  • server-functions (@NivaldoFarias) Translate server-functions.md to Portuguese #1072
  • use-client (@NivaldoFarias) Translate use-client.md to pt-br #935
  • use-server (@NivaldoFarias) Translate use-server.md to Portuguese #1073

• Rules of React (@NivaldoFarias) Translate index.md to Portuguese #1071

  • Components and Hooks must be pure (@CaioLuizDosSantos) Tradução página components-and-hooks-must-be-pure #792
  • React calls Components and Hooks (@NivaldoFarias) Translate react-calls-components-and-hooks.md to pt-br #932
  • Rules of Hooks (@NivaldoFarias) Translate rules-of-hooks.md to pt-br #931

• React Compiler Reference

  • compiling-libraries (@NivaldoFarias) Tradução de compiling-libraries.md para Português (Brasil) #1226
  • target (@NivaldoFarias) Tradução de target.md para Português (Brasil) #1227
  • compilationMode
  • configuration — PR aberto Tradução de configuration.md para Português (Brasil) #1225 (CI com falha)
  • directives
  • directives/use-memo
  • directives/use-no-memo
  • gating
  • logger
  • panicThreshold

• eslint-plugin-react-hooks (@NivaldoFarias) Tradução de index.md para Português (Brasil) #1210

  • lints/config (@NivaldoFarias) Tradução de config.md para Português (Brasil) #1212
  • lints/error-boundaries (@NivaldoFarias) Tradução de error-boundaries.md para Português (Brasil) #1211
  • lints/immutability (@NivaldoFarias) Tradução de immutability.md para Português (Brasil) #1214
  • lints/incompatible-library (@NivaldoFarias) Tradução de incompatible-library.md para Português (Brasil) #1217
  • lints/preserve-manual-memoization (@NivaldoFarias) Tradução de preserve-manual-memoization.md para Português (Brasil) #1216
  • lints/rules-of-hooks (@NivaldoFarias) Tradução de rules-of-hooks.md para Português (Brasil) #1220
  • lints/set-state-in-effect (@NivaldoFarias) Tradução de set-state-in-effect.md para Português (Brasil) #1219
  • lints/set-state-in-render (@NivaldoFarias) Tradução de set-state-in-render.md para Português (Brasil) #1221
  • lints/static-components (@NivaldoFarias) Tradução de static-components.md para Português (Brasil) #1222
  • lints/unsupported-syntax (@NivaldoFarias) Tradução de unsupported-syntax.md para Português (Brasil) #1223
  • lints/use-memo (@NivaldoFarias) Tradução de use-memo.md para Português (Brasil) #1224
  • lints/component-hook-factories
  • lints/exhaustive-deps
  • lints/gating
  • lints/globals — PR aberto Tradução de globals.md para Português (Brasil) #1213
  • lints/purity — PR aberto Tradução de purity.md para Português (Brasil) #1215
  • lints/refs — PR aberto Tradução de refs.md para Português (Brasil) #1218

• React DevTools

  • react-performance-tracks (@NivaldoFarias) Tradução de react-performance-tracks.md para Português (Brasil) #1209

Navigation e UI

• Homepage (currently in HomeContent.js) (@jhonmike) Translate React website Home page #655
• Sidebars (currently in src/sidebar*.json) (@emersonbroga) Tradução das Sidebar #663
• Top-level navigation (currently in TopNav.tsx)

---

Conteúdo Secundário

O ideal é que essas páginas também sejam traduzidas, mas são menos urgentes:

Legacy React APIs

• Children (@NivaldoFarias) Translate Children.md to Portuguese #1046
• cloneElement (@NivaldoFarias) Translate cloneElement.md to Portuguese #1059
• Component (@NivaldoFarias) Translate Component.md to Portuguese #1049
• createElement (@NivaldoFarias) Translate createElement.md to Portuguese #1056
• createRef (@NivaldoFarias) Translate createRef.md to Portuguese #1053
• isValidElement (@NivaldoFarias) Translate isValidElement.md to Portuguese #1052
• PureComponent (@NivaldoFarias) Translate PureComponent.md to Portuguese #1041

---

Conteúdo opcional

• Community

  • team (@NivaldoFarias) Translate team.md to Portuguese #989
  • docs-contributors (@NivaldoFarias) Translate docs-contributors.md to Portuguese #984
  • translations (@NivaldoFarias) Translate translations.md to Portuguese #983
  • versioning-policy (@NivaldoFarias) Translate versioning-policy.md to Portuguese #990
  • videos (@NivaldoFarias) Translate videos.md to Portuguese #985
  • acknowledgements
  • conferences (lista internacional — mantida em inglês)
  • meetups (lista internacional — mantida em inglês)

• Blog (parcialmente traduzido — ver seção Blog acima)

• Warnings (@pedrocraveiro) Translate Optional Content: Warnings #767

  • invalid-aria-prop
  • invalid-hook-call-warning
  • react-dom-test-utils
  • react-test-renderer
  • special-props
  • unknown-prop

• Errors (@NivaldoFarias) Translate index.md to Portuguese #993

  • 377 (@NivaldoFarias) Translate 377.md to Portuguese #995
  • generic (@NivaldoFarias) Translate generic.md to Portuguese #994

• versions.md (@NivaldoFarias) Translate versions.md to pt-br #936

[jwandekoken]

Opa. Como posso contribuir com a tradução? (newcomer, sry xD)
Nos organizamos por aqui mesmo, ou temos uma tabela do que já está sendo feito ou algo do tipo?

[eduardomoroni]

Show de bola @jwandekoken , eu atualizei o meu post ali em cima. Basicamente escolhe uma página, traduz e manda um PR.
O que eu faço no verdade é, eu uso uma ferramenta de traduçao, Deepl por exemplo, traduzo a página usando a ferramenta. Depois eu vou lendo os dois e corrigindo o tradutor.
Eu acho mais rápido e fácil, mas você pode traduzir você mesmo do zero também.

[jwandekoken]

learn - @jwandekoken

[walerya]

Olá! Tenho português nativo e, além disso, sou graduada em língua portuguesa, estou estudando TW e gostaria de contribuir com a tradução.

[jwandekoken]

@Waleryaa, escolha uma das páginas e mete bala, o @eduardomoroni mencionou sobre o processo. Caso tenha alguma dúvida ou dificuldade de como fazer, posso te auxiliar (no processo de forkar o repo, baixar, trabalhar no arquivo e subir o PR). Qualquer coisa, só falar!

[walerya]

@jwandekoken Toda ajuda é bem-vinda, até porque esse será meu primeiro projeto aqui no GitHub. Obrigada pela disposição.

[walerya]

Vou fazer "meet-the-team.md". Não sei como colocar na planilha.

[eduardomoroni]

Uma outra grande ajuda @Waleryaa seria dar uma olhada nos Pull Requests ja aberto e revisar. Certifique-se de dar uma revisao "formal", ou seja, enviar uma revisao atraves da aba 'files changed'. Assim a gente ja sabe quais podem ser mergeado.

[walerya]

Obrigada, @eduardomoroni! Farei isso.

[walerya]

Oie! Estou procurando uma nova task para fazer (aproveitando que estou de férias hahaha) e notei que algumas já foram feitas, mas não estão marcadas. É isso mesmo?