diff --git a/beta/src/pages/apis/render.md b/beta/src/pages/apis/render.md index f9b7c8b77..9226a4897 100644 --- a/beta/src/pages/apis/render.md +++ b/beta/src/pages/apis/render.md @@ -4,7 +4,7 @@ title: render -`render` renders a piece of [JSX](/learn/writing-markup-with-jsx) ("React node") into a browser DOM node. +`render` renderiza um pedaço de [JSX](/learn/writing-markup-with-jsx) ("nó React") em um nó do DOM do navegador. ```js render(reactNode, domNode, callback?) @@ -12,18 +12,18 @@ render(reactNode, domNode, callback?) -- [Usage](#usage) - - [Rendering the root component](#rendering-the-root-component) - - [Rendering multiple roots](#rendering-multiple-roots) - - [Updating the rendered tree](#updating-the-rendered-tree) -- [Reference](#reference) +- [Uso](#usage) + - [Renderizando o componente raiz](#rendering-the-root-component) + - [Renderizando várias raízes](#rendering-multiple-roots) + - [Atualizando a árvore renderizada](#updating-the-rendered-tree) +- [Referência](#reference) - [`render(reactNode, domNode, callback?)`](#render) --- -## Usage {/*usage*/} +## Uso {/*usage*/} -Call `render` to display a React component inside a browser DOM node. +Chame `render` para exibir um componente React dentro de um nó do DOM do navegador. ```js [[1, 4, ""], [2, 4, "document.getElementById('root')"]] import {render} from 'react-dom'; @@ -32,9 +32,9 @@ import App from './App.js'; render(, document.getElementById('root')); ```` -### Rendering the root component {/*rendering-the-root-component*/} +### Renderizando o componente raiz {/*rendering-the-root-component*/} -In apps fully built with React, **you will usually only do this once at startup**--to render the "root" component. +Em aplicativos totalmente construídos com React, **você normalmente só fará isso uma vez na inicialização** -- para renderizar o componente "raiz". @@ -48,26 +48,26 @@ render(, document.getElementById('root')); ```js App.js export default function App() { - return

Hello, world!

; + return

Olá, mundo!

; } ```
-Usually you shouldn't need to call `render` again or to call it in more places. From this point on, React will be managing the DOM of your application. If you want to update the UI, your components can do this by [using state](/apis/usestate). +Normalmente você não precisa chamar `render` novamente ou chamá-lo em mais lugares. A partir deste ponto, o React estará gerenciando o DOM de sua aplicação. Se você deseja atualizar a interface do usuário, seus componentes podem fazer isso [usando o estado](/apis/usestate). --- -### Rendering multiple roots {/*rendering-multiple-roots*/} +### Renderizando várias raízes {/*rendering-multiple-roots*/} -If your page [isn't fully built with React](/learn/add-react-to-a-website), call `render` for each top-level piece of UI managed by React. +Se sua página [não for totalmente construída com React](/learn/add-react-to-a-website), chame `render` para cada parte da interface de usuário de nível superior gerenciada pelo React. ```html public/index.html
-

This paragraph is not rendered by React (open index.html to verify).

+

Este parágrafo não é renderizado pelo React (abra index.html para verificar).

``` @@ -93,7 +93,7 @@ export function Navigation() { return (
    Home - About + Sobre
); } @@ -109,9 +109,9 @@ function NavLink({ href, children }) { export function Comments() { return ( <> -

Comments

- - +

Comentários

+ + ); } @@ -130,13 +130,13 @@ nav ul li { display: inline-block; margin-right: 20px; }
-You can destroy the rendered trees with [`unmountComponentAtNode()`](TODO). +Você pode destruir as árvores renderizadas com [`unmountComponentAtNode()`](TODO). --- -### Updating the rendered tree {/*updating-the-rendered-tree*/} +### Atualizando a árvore renderizada {/*updating-the-rendered-tree*/} -You can call `render` more than once on the same DOM node. As long as the component tree structure matches up with what was previously rendered, React will [preserve the state](/learn/preserving-and-resetting-state). Notice how you can type in the input, which means that the updates from repeated `render` calls every second in this example are not destructive: +Você pode chamar `render` mais de uma vez no mesmo nó do DOM. Contanto que a estrutura da árvore de componentes corresponda ao que foi renderizado anteriormente, o React [preservará o estado](/learn/preserving-and-resetting-state). Observe como você pode digitar a entrada, o que significa que as atualizações de chamadas `render` repetidas a cada segundo neste exemplo não são destrutivas: @@ -159,8 +159,8 @@ setInterval(() => { export default function App({counter}) { return ( <> -

Hello, world! {counter}

- +

Olá mundo! {counter}

+ ); } @@ -168,46 +168,46 @@ export default function App({counter}) {
-It is uncommon to call `render` multiple times. Usually, you'll [update state](/apis/usestate) inside one of the components instead. +É incomum chamar `render` várias vezes. Normalmente, você [atualiza o estado](/apis/usestate) dentro de um dos componentes. --- -## Reference {/*reference*/} +## Referência {/*reference*/} ### `render(reactNode, domNode, callback?)` {/*render*/} -Call `render` to display a React component inside a browser DOM element. +Chame `render` para exibir um componente React dentro de um elemento DOM do navegador. ```js const domNode = document.getElementById('root'); render(, domNode); ``` -React will display `` in the `domNode`, and take over managing the DOM inside it. +O React exibirá `` no `domNode` e assumirá o gerenciamento do DOM dentro dele. -An app fully built with React will usually only have one `render` call with its root component. A page that uses "sprinkles" of React for parts of the page may have as many `render` calls as needed. +Um aplicativo totalmente construído com React geralmente terá apenas uma chamada `render` com seu componente raiz. Uma página que usa "pedaços" de React para partes da página pode ter quantas chamadas `render` quantas forem necessárias. -[See examples above.](#usage) +[Veja exemplos acima.](#usage) -#### Parameters {/*parameters*/} +#### Parâmetros {/*parameters*/} -* `reactNode`: A *React node* that you want to display. This will usually be a piece of JSX like ``, but you can also pass a React element constructed with [`createElement()`](/TODO), a string, a number, `null`, or `undefined`. +* `reactNode`: Um *nó React* que você deseja exibir. Isso geralmente será um pedaço de JSX como ``, mas você também pode passar um elemento React construído com [`createElement()`](/TODO), uma string, um número, `null` ou `undefined`. -* `domNode`: A [DOM element](https://developer.mozilla.org/en-US/docs/Web/API/Element). React will display the `reactNode` you pass inside this DOM element. From this moment, React will manage the DOM inside the `domNode` and update it when your React tree changes. +* `domNode`: Um [elemento DOM](https://developer.mozilla.org/en-US/docs/Web/API/Element). O React exibirá o `reactNode` que você passar dentro deste elemento DOM. A partir deste momento, o React irá gerenciar o DOM dentro do `domNode` e atualizá-lo quando sua árvore do React mudar. -* **optional** `callback`: A function. If passed, React will call it after your component is placed into the DOM. +* **opcional** `callback`: Uma função. Se aprovado, o React irá chamá-lo depois que seu componente for colocado no DOM. -#### Returns {/*returns*/} +#### Retornos {/*returns*/} -`render` usually returns `null`. However, if the `reactNode` you pass is a *class component*, then it will return an instance of that component. +`render` geralmente retorna `null`. No entanto, se o `reactNode` que você passar for um *componente de classe*, ele retornará uma instância desse componente. -#### Caveats {/*caveats*/} +#### Ressalvas {/*caveats*/} -* The first time you call `render`, React will clear all the existing HTML content inside the `domNode` before rendering the React component into it. If your `domNode` contains HTML generated by React on the server or during the build, use [`hydrate()`](/TODO) instead, which attaches the event handlers to the existing HTML. +* A primeira vez que você chamar `render`, o React irá limpar todo o conteúdo HTML existente dentro do `domNode` antes de renderizar o componente React nele. Se o seu `domNode` contém HTML gerado pelo React no servidor ou durante a compilação, use [`hydrate()`](/TODO), que anexa os manipuladores de eventos ao HTML existente. -* If you call `render` on the same `domNode` more than once, React will update the DOM as necessary to reflect the latest JSX you passed. React will decide which parts of the DOM can be reused and which need to be recreated by ["matching it up"](/learn/preserving-and-resetting-state) with the previously rendered tree. Calling `render` on the same `domNode` again is similar to calling the [`set` function](/apis/usestate#setstate) on the root component: React avoids unnecessary DOM updates. +* Se você chamar `render` no mesmo `domNode` mais de uma vez, o React irá atualizar o DOM conforme necessário para refletir o último JSX que você passou. O React decidirá quais partes do DOM podem ser reutilizadas e quais precisam ser recriadas ["combinando"](/learn/preserving-and-resetting-state) com a árvore renderizada anteriormente. Chamar `render` no mesmo `domNode` novamente é semelhante a chamar a função [`set`](/apis/usestate#setstate) no componente raiz: React evita atualizações desnecessárias do DOM. -* If your app is fully built with React, you'll likely have only one `render` call in your app. (If you use a framework, it might do this call for you.) When you want to render a piece of JSX in a different part of the DOM tree that isn't a child of your component (for example, a modal or a tooltip), use [`createPortal`](TODO) instead of `render`. +* Se seu aplicativo for totalmente construído com React, você provavelmente terá apenas uma chamada `render` em seu aplicativo. (Se você usa um framework, ele pode fazer essa chamada para você.) Quando você deseja renderizar uma parte do JSX em uma parte diferente da árvore DOM que não é filho do seu componente (por exemplo, um modal ou um dica de ferramenta), use [`createPortal`](TODO) em vez de `render`. ---