`'s `color` to red without impacting `background-color`. Similarly, **different React contexts don't override each other.** Each context that you make with `createContext()` is completely separate from other ones, and ties together components using and providing *that particular* context. One component may use or provide many different contexts without a problem.
+No CSS, propriedades diferentes como `color` e `background-color` não sobrescrevem umas às outras. Você pode definir a `color` de todas as `
` como vermelha sem afetar a `background-color`. Da mesma forma, **contextos diferentes do React não sobrescrevem uns aos outros.** Cada contexto que você cria com `createContext()` é completamente separado dos outros e une os componentes que usam e fornecem *especificamente aquele* contexto. Um componente pode usar ou fornecer muitos contextos diferentes sem problemas.
-## Before you use context {/*before-you-use-context*/}
+## Antes de usar contexto {/*before-you-use-context*/}
-Context is very tempting to use! However, this also means it's too easy to overuse it. **Just because you need to pass some props several levels deep doesn't mean you should put that information into context.**
+O contexto é muito tentador de usar! No entanto, isso também significa que é fácil demais usá-lo em excesso. **Só porque você precisa passar algumas props vários níveis abaixo não significa que você deva colocar essa informação no contexto.**
-Here's a few alternatives you should consider before using context:
+Aqui estão algumas alternativas que você deve considerar antes de usar o contexto:
-1. **Start by [passing props.](/learn/passing-props-to-a-component)** If your components are not trivial, it's not unusual to pass a dozen props down through a dozen components. It may feel like a slog, but it makes it very clear which components use which data! The person maintaining your code will be glad you've made the data flow explicit with props.
-2. **Extract components and [pass JSX as `children`](/learn/passing-props-to-a-component#passing-jsx-as-children) to them.** If you pass some data through many layers of intermediate components that don't use that data (and only pass it further down), this often means that you forgot to extract some components along the way. For example, maybe you pass data props like `posts` to visual components that don't use them directly, like `
`. Instead, make `Layout` take `children` as a prop, and render `
`. This reduces the number of layers between the component specifying the data and the one that needs it.
+1. **Comece [passando props.](/learn/passing-props-to-a-component)** Se seus componentes não forem triviais, não é incomum passar uma dúzia de props por uma dúzia de componentes. Pode parecer um trabalho maçante, mas isso deixa muito claro quais componentes usam quais dados! A pessoa que mantém seu código ficará feliz por você ter tornado o fluxo de dados explícito com props.
+2. **Extraia componentes e [passe JSX como `children`](/learn/passing-props-to-a-component#passing-jsx-as-children) para eles.** Se você passa alguns dados por muitas camadas de componentes intermediários que não usam esses dados (e apenas os repassam adiante), isso muitas vezes significa que você se esqueceu de extrair alguns componentes pelo caminho. Por exemplo, talvez você passe props de dados como `posts` para componentes visuais que não as usam diretamente, como `
`. Em vez disso, faça `Layout` receber `children` como prop e renderize `
`. Isso reduz o número de camadas entre o componente que especifica os dados e aquele que precisa deles.
-If neither of these approaches works well for you, consider context.
+Se nenhuma dessas abordagens funcionar bem para você, considere o contexto.
-## Use cases for context {/*use-cases-for-context*/}
+## Casos de uso para contexto {/*use-cases-for-context*/}
-* **Theming:** If your app lets the user change its appearance (e.g. dark mode), you can put a context provider at the top of your app, and use that context in components that need to adjust their visual look.
-* **Current account:** Many components might need to know the currently logged in user. Putting it in context makes it convenient to read it anywhere in the tree. Some apps also let you operate multiple accounts at the same time (e.g. to leave a comment as a different user). In those cases, it can be convenient to wrap a part of the UI into a nested provider with a different current account value.
-* **Routing:** Most routing solutions use context internally to hold the current route. This is how every link "knows" whether it's active or not. If you build your own router, you might want to do it too.
-* **Managing state:** As your app grows, you might end up with a lot of state closer to the top of your app. Many distant components below may want to change it. It is common to [use a reducer together with context](/learn/scaling-up-with-reducer-and-context) to manage complex state and pass it down to distant components without too much hassle.
+* **Temas:** Se sua aplicação permite que o usuário mude a aparência dela (por exemplo, modo escuro), você pode colocar um provedor de contexto no topo da sua aplicação e usar esse contexto nos componentes que precisam ajustar sua aparência visual.
+* **Conta atual:** Muitos componentes podem precisar saber qual é o usuário logado no momento. Colocá-lo no contexto torna conveniente lê-lo em qualquer lugar da árvore. Algumas aplicações também permitem que você opere várias contas ao mesmo tempo (por exemplo, para deixar um comentário como outro usuário). Nesses casos, pode ser conveniente envolver uma parte da UI em um provedor aninhado com um valor diferente de conta atual.
+* **Roteamento:** A maioria das soluções de roteamento usa contexto internamente para guardar a rota atual. É assim que cada link "sabe" se está ativo ou não. Se você construir seu próprio roteador, talvez queira fazer isso também.
+* **Gerenciamento de estado:** À medida que sua aplicação cresce, você pode acabar com muito estado mais perto do topo da sua aplicação. Muitos componentes distantes abaixo podem querer alterá-lo. É comum [usar um reducer junto com o contexto](/learn/scaling-up-with-reducer-and-context) para gerenciar estado complexo e passá-lo para componentes distantes sem muita complicação.
-Context is not limited to static values. If you pass a different value on the next render, React will update all the components reading it below! This is why context is often used in combination with state.
+O contexto não se limita a valores estáticos. Se você passar um valor diferente na próxima renderização, o React atualizará todos os componentes abaixo que o leem! É por isso que o contexto é frequentemente usado em combinação com o estado.
-In general, if some information is needed by distant components in different parts of the tree, it's a good indication that context will help you.
+Em geral, se alguma informação é necessária para componentes distantes em diferentes partes da árvore, é um bom indício de que o contexto vai ajudar você.
-* Context lets a component provide some information to the entire tree below it.
-* To pass context:
- 1. Create and export it with `export const MyContext = createContext(defaultValue)`.
- 2. Pass it to the `useContext(MyContext)` Hook to read it in any child component, no matter how deep.
- 3. Wrap children into `` to provide it from a parent.
-* Context passes through any components in the middle.
-* Context lets you write components that "adapt to their surroundings".
-* Before you use context, try passing props or passing JSX as `children`.
+* O contexto permite que um componente forneça algumas informações para toda a árvore abaixo dele.
+* Para passar contexto:
+ 1. Crie-o e exporte-o com `export const MyContext = createContext(defaultValue)`.
+ 2. Passe-o para o Hook `useContext(MyContext)` para lê-lo em qualquer componente filho, não importa quão profundo.
+ 3. Envolva os filhos em `` para fornecê-lo a partir de um pai.
+* O contexto passa por quaisquer componentes intermediários.
+* O contexto permite que você escreva componentes que "se adaptam ao ambiente ao seu redor".
+* Antes de usar contexto, tente passar props ou passar JSX como `children`.
-#### Replace prop drilling with context {/*replace-prop-drilling-with-context*/}
+#### Substitua prop drilling por contexto {/*replace-prop-drilling-with-context*/}
-In this example, toggling the checkbox changes the `imageSize` prop passed to each ``. The checkbox state is held in the top-level `App` component, but each `` needs to be aware of it.
+Neste exemplo, marcar ou desmarcar a caixa de seleção muda a prop `imageSize` passada para cada ``. O estado da caixa de seleção é mantido no componente `App` de nível superior, mas cada `` precisa estar ciente dele.
-Currently, `App` passes `imageSize` to `List`, which passes it to each `Place`, which passes it to the `PlaceImage`. Remove the `imageSize` prop, and instead pass it from the `App` component directly to `PlaceImage`.
+Atualmente, `App` passa `imageSize` para `List`, que a passa para cada `Place`, que a passa para `PlaceImage`. Remova a prop `imageSize` e, em vez disso, passe-a diretamente do componente `App` para `PlaceImage`.
-You can declare context in `Context.js`.
+Você pode declarar o contexto em `Context.js`.
@@ -1020,9 +1020,9 @@ li {
-Remove `imageSize` prop from all the components.
+Remova a prop `imageSize` de todos os componentes.
-Create and export `ImageSizeContext` from `Context.js`. Then wrap the List into `` to pass the value down, and `useContext(ImageSizeContext)` to read it in the `PlaceImage`:
+Crie e exporte `ImageSizeContext` a partir de `Context.js`. Em seguida, envolva a List em `` para passar o valor para baixo, e use `useContext(ImageSizeContext)` para lê-lo em `PlaceImage`:
@@ -1157,7 +1157,7 @@ li {
-Note how components in the middle don't need to pass `imageSize` anymore.
+Observe como os componentes intermediários não precisam mais passar `imageSize`.