Skip to content

Commit 4094e00

Browse files
ifdiegoglaucia86
authored andcommitted
Translate Components and Props (reactjs#23)
* Translate Components and Props * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]> * Update content/docs/components-and-props.md Co-Authored-By: ifdiego <[email protected]>
1 parent d47a0b5 commit 4094e00

File tree

1 file changed

+45
-45
lines changed

1 file changed

+45
-45
lines changed

content/docs/components-and-props.md

Lines changed: 45 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
id: components-and-props
3-
title: Components and Props
3+
title: Componentes e Props
44
permalink: docs/components-and-props.html
55
redirect_from:
66
- "docs/reusable-components.html"
@@ -16,23 +16,23 @@ prev: rendering-elements.html
1616
next: state-and-lifecycle.html
1717
---
1818

19-
Components let you split the UI into independent, reusable pieces, and think about each piece in isolation. This page provides an introduction to the idea of components. You can find a [detailed component API reference here](/docs/react-component.html).
19+
Componentes permitem você dividir a UI em partes independentes, reutilizáveis e pensar em cada parte isoladamente. Essa página fornece uma introdução à ideia de componentes. Você pode encontrar uma [referência detalhada da API de componente aqui](/docs/react-component.html).
2020

21-
Conceptually, components are like JavaScript functions. They accept arbitrary inputs (called "props") and return React elements describing what should appear on the screen.
21+
Conceitualmente, componentes são como funções JavaScript. Eles aceitam entradas arbitrárias (chamadas "props") e retornam elementos React que descrevem o que deve aparecer na tela.
2222

23-
## Function and Class Components {#function-and-class-components}
23+
## Componentes de Função e Classe {#function-and-class-components}
2424

25-
The simplest way to define a component is to write a JavaScript function:
25+
A maneira mais simples de definir um componente é escrever uma função JavaScript:
2626

2727
```js
2828
function Welcome(props) {
2929
return <h1>Hello, {props.name}</h1>;
3030
}
3131
```
3232

33-
This function is a valid React component because it accepts a single "props" (which stands for properties) object argument with data and returns a React element. We call such components "function components" because they are literally JavaScript functions.
33+
Essa função é um componente React válido porque aceita um único argumento de objeto "props" (que significa propriedades) com dados e retorna um elemento React. Nós chamamos esses componentes de "componentes de função" porque são literalmente funções JavaScript.
3434

35-
You can also use an [ES6 class](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Classes) to define a component:
35+
Você também pode usar uma [classe ES6](https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Classes) para definir um componente:
3636

3737
```js
3838
class Welcome extends React.Component {
@@ -42,27 +42,27 @@ class Welcome extends React.Component {
4242
}
4343
```
4444

45-
The above two components are equivalent from React's point of view.
45+
Os dois componentes acima são equivalentes do ponto de vista do React.
4646

47-
Classes have some additional features that we will discuss in the [next sections](/docs/state-and-lifecycle.html). Until then, we will use function components for their conciseness.
47+
Classes tem alguns recursos adicionais que nós discutiremos nas [próximas seções](/docs/state-and-lifecycle.html). Até lá, nós usaremos componentes de função por serem mais sucintos.
4848

49-
## Rendering a Component {#rendering-a-component}
49+
## Renderizando um Componente {#rendering-a-component}
5050

51-
Previously, we only encountered React elements that represent DOM tags:
51+
Anteriormente, nós encontramos apenas elementos React que representam tags do DOM:
5252

5353
```js
5454
const element = <div />;
5555
```
5656

57-
However, elements can also represent user-defined components:
57+
No entanto, elementos também podem representar componentes definidos pelo usuário:
5858

5959
```js
6060
const element = <Welcome name="Sara" />;
6161
```
6262

63-
When React sees an element representing a user-defined component, it passes JSX attributes to this component as a single object. We call this object "props".
63+
Quando o React vê um elemento representando um componente definido pelo usuário, ele passa atributos JSX para esse componente como um único objeto. Nós chamamos esse objeto de "props".
6464

65-
For example, this code renders "Hello, Sara" on the page:
65+
Por exemplo, esse código renderiza "Hello, Sara" na página:
6666

6767
```js{1,5}
6868
function Welcome(props) {
@@ -78,24 +78,24 @@ ReactDOM.render(
7878

7979
[](codepen://components-and-props/rendering-a-component)
8080

81-
Let's recap what happens in this example:
81+
Vamos recapitular o que acontece nesse exemplo:
8282

83-
1. We call `ReactDOM.render()` with the `<Welcome name="Sara" />` element.
84-
2. React calls the `Welcome` component with `{name: 'Sara'}` as the props.
85-
3. Our `Welcome` component returns a `<h1>Hello, Sara</h1>` element as the result.
86-
4. React DOM efficiently updates the DOM to match `<h1>Hello, Sara</h1>`.
83+
1. Nós chamamos `ReactDOM.render()` com o elemento `<Welcome name="Sara" />`.
84+
2. React chama o componente `Welcome` com `{name: 'Sara'}` como props.
85+
3. Nosso componente `Welcome` retorna um elemento `<h1>Hello, Sara</h1>` como resultado.
86+
4. React DOM atualiza eficientemente o DOM para corresponder `<h1>Hello, Sara</h1>`.
8787

88-
>**Note:** Always start component names with a capital letter.
88+
>**Nota:** Sempre inicie os nomes dos componentes com uma letra maiúscula.
8989
>
90-
>React treats components starting with lowercase letters as DOM tags. For example, `<div />` represents an HTML div tag, but `<Welcome />` represents a component and requires `Welcome` to be in scope.
90+
>O React trata componentes começando com letras minúsculas como tags do DOM. Por exemplo, `<div />` representa uma tag div do HTML, mas `<Welcome />` representa um componente e requer que `Welcome` esteja no escopo.
9191
>
92-
>You can read more about the reasoning behind this convention [here.](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized)
92+
>Você pode ler mais sobre o raciocínio por trás dessa convenção [aqui.](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized)
9393
94-
## Composing Components {#composing-components}
94+
## Compondo Componentes {#composing-components}
9595

96-
Components can refer to other components in their output. This lets us use the same component abstraction for any level of detail. A button, a form, a dialog, a screen: in React apps, all those are commonly expressed as components.
96+
Componentes podem se referir a outros componentes em sua saída. Isso nos permite usar a mesma abstração de componente para qualquer nível de detalhe. Um botão, um formulário, uma caixa de diálogo, uma tela: em aplicativos React, todos esses são normalmente expressos como componentes.
9797

98-
For example, we can create an `App` component that renders `Welcome` many times:
98+
Por exemplo, nós podemos criar um componente `App` que renderiza `Welcome` muitas vezes:
9999

100100
```js{8-10}
101101
function Welcome(props) {
@@ -120,13 +120,13 @@ ReactDOM.render(
120120

121121
[](codepen://components-and-props/composing-components)
122122

123-
Typically, new React apps have a single `App` component at the very top. However, if you integrate React into an existing app, you might start bottom-up with a small component like `Button` and gradually work your way to the top of the view hierarchy.
123+
Tipicamente, novos aplicativos React tem um único componente `App` no topo. Contudo, se você integrar o React em um aplicativo existente, você pode começar de baixo para cima com um pequeno componente como o `Button` e gradualmente chegar ao topo da hierarquia de exibição.
124124

125-
## Extracting Components {#extracting-components}
125+
## Extraindo Componentes {#extracting-components}
126126

127-
Don't be afraid to split components into smaller components.
127+
Não tenha medo de dividir componentes em componentes menores.
128128

129-
For example, consider this `Comment` component:
129+
Por exemplo, considere esse commponente `Comment`:
130130

131131
```js
132132
function Comment(props) {
@@ -154,11 +154,11 @@ function Comment(props) {
154154

155155
[](codepen://components-and-props/extracting-components)
156156

157-
It accepts `author` (an object), `text` (a string), and `date` (a date) as props, and describes a comment on a social media website.
157+
Ele aceita `author` (um objeto), `text` (uma string) e `date` (uma data) como props e descreve um comentário em um site de mídia social.
158158

159-
This component can be tricky to change because of all the nesting, and it is also hard to reuse individual parts of it. Let's extract a few components from it.
159+
Esse componente pode ser complicado de alterar por causa de todo o aninhamento. Também é difícil reutilizar suas partes individuais. Vamos extrair alguns componentes dele.
160160

161-
First, we will extract `Avatar`:
161+
Primeiro, nós vamos extrair `Avatar`:
162162

163163
```js{3-6}
164164
function Avatar(props) {
@@ -171,11 +171,11 @@ function Avatar(props) {
171171
}
172172
```
173173

174-
The `Avatar` doesn't need to know that it is being rendered inside a `Comment`. This is why we have given its prop a more generic name: `user` rather than `author`.
174+
O `Avatar` não precisa saber que está sendo renderizado dentro do `Comment`. É por isso que nós demos ao seu prop um nome mais genérico: `user` em vez de `author`.
175175

176-
We recommend naming props from the component's own point of view rather than the context in which it is being used.
176+
Nós recomendamos nomear props a partir do ponto de vista do próprio componente ao invés do contexto em que ele está sendo usado.
177177

178-
We can now simplify `Comment` a tiny bit:
178+
Agora nós podemos simplificar `Comment` um pouco mais:
179179

180180
```js{5}
181181
function Comment(props) {
@@ -198,7 +198,7 @@ function Comment(props) {
198198
}
199199
```
200200

201-
Next, we will extract a `UserInfo` component that renders an `Avatar` next to the user's name:
201+
Em seguida, nós vamos extrair o componente `UserInfo` que renderiza um `Avatar` ao lado do nome do usuário:
202202

203203
```js{3-8}
204204
function UserInfo(props) {
@@ -213,7 +213,7 @@ function UserInfo(props) {
213213
}
214214
```
215215

216-
This lets us simplify `Comment` even further:
216+
Isso nos permite simplificar `Comment` ainda mais:
217217

218218
```js{4}
219219
function Comment(props) {
@@ -233,30 +233,30 @@ function Comment(props) {
233233

234234
[](codepen://components-and-props/extracting-components-continued)
235235

236-
Extracting components might seem like grunt work at first, but having a palette of reusable components pays off in larger apps. A good rule of thumb is that if a part of your UI is used several times (`Button`, `Panel`, `Avatar`), or is complex enough on its own (`App`, `FeedStory`, `Comment`), it is a good candidate to be a reusable component.
236+
Extrair componentes pode parecer um trabalho pesado no começo, mas ter uma paleta de componentes reutilizáveis compensa em aplicativos maiores. Uma boa regra é que se uma parte da sua UI for usada várias vezes (`Button`, `Panel`, `Avatar`) ou for complexa o suficiente por si só (`App`, `FeedStory`, `Comment`) é uma boa candidata a se tornar um componente reutilizável.
237237

238-
## Props are Read-Only {#props-are-read-only}
238+
## Props são Somente Leitura {#props-are-read-only}
239239

240-
Whether you declare a component [as a function or a class](#function-and-class-components), it must never modify its own props. Consider this `sum` function:
240+
Independente se você declarar um componente [como uma função ou uma classe](#function-and-class-components), ele nunca deve modificar seus próprios props. Considere essa função `sum`:
241241

242242
```js
243243
function sum(a, b) {
244244
return a + b;
245245
}
246246
```
247247

248-
Such functions are called ["pure"](https://en.wikipedia.org/wiki/Pure_function) because they do not attempt to change their inputs, and always return the same result for the same inputs.
248+
Tais funções são chamadas ["puras"](https://en.wikipedia.org/wiki/Pure_function) porque elas não tentam alterar suas entradas e sempre retornan o mesmo resultado para as mesmas entradas.
249249

250-
In contrast, this function is impure because it changes its own input:
250+
Em contraste, essa função é impura porque altera sua própria entrada:
251251

252252
```js
253253
function withdraw(account, amount) {
254254
account.total -= amount;
255255
}
256256
```
257257

258-
React is pretty flexible but it has a single strict rule:
258+
React é bastante flexível mas tem uma única regra estrita:
259259

260-
**All React components must act like pure functions with respect to their props.**
260+
**Todos os componentes React tem que agir como funções puras em relação ao seus props.**
261261

262-
Of course, application UIs are dynamic and change over time. In the [next section](/docs/state-and-lifecycle.html), we will introduce a new concept of "state". State allows React components to change their output over time in response to user actions, network responses, and anything else, without violating this rule.
262+
Obviamente, as UIs de aplicativos são dinâmicas e mudam com o tempo. Na [próxima seção](/docs/state-and-lifecycle.html), nós vamos introduzir um novo conceito de "state". O state permite aos componentes React alterar sua saída ao longo do tempo em resposta a ações do usuário, respostas de rede e quaisquer outras coisas, sem violar essa regra.

0 commit comments

Comments
 (0)