Skip to content

Commit 8c65a79

Browse files
authored
Review on guide/reactivity-fundamentals
1 parent f17c3e0 commit 8c65a79

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

src/guide/reactivity-fundamentals.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Fundamentos de Reatividade
1+
# Fundamentos da Reatividade
22

3-
## Declaração de Estado Reativo
3+
## Declarando Estado Reativo
44

55
Para criar um estado reativo a partir de um objeto JavaScript, podemos usar o método `reactive`:
66

@@ -13,17 +13,17 @@ const state = reactive({
1313
})
1414
```
1515

16-
`reactive` é o equivalente a `Vue.observable()` da API no Vue 2.x, renomeado para evitar confusoes com os observables RxJS. Aqui, o estado retornado é um objeto reativo. A conversão reativa é "profunda" - ela afeta todas as propriedades aninhadas do objeto passado.
16+
`reactive` é equivalente à API `Vue.observable()` do Vue 2.x, renomeado para evitar confusões com os `Observables` do RxJS. Aqui, o estado retornado é um objeto reativo. A conversão reativa é "profunda" - ela afeta todas as propriedades aninhadas do objeto passado.
1717

1818
O caso de uso essencial para o estado reativo no Vue é que podemos usá-lo durante a renderização. Graças ao rastreamento de dependência, a exibição é atualizada automaticamente quando o estado reativo muda.
1919

20-
Esta é a própria essência do sistema de reatividade do Vue. Quando você retorna um objeto de `data()` em um componente, ele é tornado reativo internamente pelo `reactive()`. O modelo é compilado em uma [função de renderização](render-function.html) que faz uso dessas propriedades reativas.
20+
Esta é a própria essência do sistema de reatividade do Vue. Quando você retorna um objeto de `data()` em um componente, ele é tornado reativo internamente pelo `reactive()`. O _template_ é compilado em uma [função de renderização](render-function.html) que faz uso dessas propriedades reativas.
2121

22-
Você pode aprender mais sobre `reactive` na seção [API de reatividade básica](../api/basic-reactivity.html)
22+
Você pode aprender mais sobre `reactive` na seção [Básico da API de Reatividade](../api/basic-reactivity.html)
2323

24-
## Criação de Valores Reativos Autônomos como `refs`
24+
## Criação de Valores Reativos Avulsos como `refs`
2525

26-
Imagine o caso em que temos um valor primitivo autônomo (por exemplo, uma string) e queremos torná-la reativa. Claro, poderíamos fazer um objeto com uma única propriedade igual à nossa string e passá-la para `reactive`. Vue tem um método que fará o mesmo para nós - ele é o `ref`:
26+
Imagine o caso em que temos um valor primitivo avulso (por exemplo, uma string) e queremos torná-la reativa. Claro, poderíamos fazer um objeto com uma única propriedade igual à nossa string e passá-la para `reactive`. Vue tem um método que fará o mesmo para nós - ele é o `ref`:
2727

2828
```js
2929
import { ref } from 'vue'
@@ -45,13 +45,13 @@ console.log(count.value) // 1
4545

4646
### Ref Desempacotada
4747

48-
Quando um ref é retornado como uma propriedade no contexto de renderização (o objeto retornado de [setup()](composition-api-setup.html)) e acessado no modelo, ele se desempacota automaticamente para o valor interno. Não há necessidade de anexar `.value` no modelo:
48+
Quando um `ref` é retornado como uma propriedade no contexto de renderização (o objeto retornado de [setup()](composition-api-setup.html)) e acessado no _template_, ele se desempacota automaticamente para o valor interno. Não há necessidade de anexar `.value` no _template_:
4949

5050
```vue-html
5151
<template>
5252
<div>
5353
<span>{{ count }}</span>
54-
<button @click="count ++">Incrementar contador</button>
54+
<button @click="count++">Incrementar contador</button>
5555
</div>
5656
</template>
5757
@@ -68,7 +68,7 @@ Quando um ref é retornado como uma propriedade no contexto de renderização (o
6868
</script>
6969
```
7070

71-
### Acesso em objetos Reativos
71+
### Acesso em Objetos Reativos
7272

7373
Quando um `ref` é acessado ou alterado como uma propriedade de um objeto reativo, ele se desempacota automaticamente para o valor interno para que se comporte como uma propriedade normal:
7474

@@ -84,7 +84,7 @@ state.count = 1
8484
console.log(count.value) // 1
8585
```
8686

87-
Se uma nova ref for atribuída a uma propriedade vinculada a uma ref existente, ela substituirá a antiga ref:
87+
Se uma nova `ref` for atribuída à uma propriedade vinculada à uma `ref` existente, ela substituirá a antiga ref:
8888

8989
```js
9090
const otherCount = ref(2)
@@ -94,30 +94,30 @@ console.log(state.count) // 2
9494
console.log(count.value) // 1
9595
```
9696

97-
O desempacotamento de um ref só acontece quando aninhado dentro de um `Object` reativo. Não há desempacotamento executado quando o ref é acessado de um `Array` ou um tipo de coleção nativo como [`Map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map):
97+
O desempacotamento de um `ref` só acontece quando aninhado dentro de um `Object` reativo. Não há desempacotamento executado quando o `ref` é acessado de um `Array` ou um tipo de coleção nativo como [`Map`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map):
9898

9999
```js
100-
const books = reactive([ref('Vue 3 Guide')])
101-
// precisa utilizar .value aqui
100+
const books = reactive([ref('Guia do Vue 3')])
101+
// precisa usar .value aqui
102102
console.log(books[0].value)
103103

104104
const map = reactive(new Map([['count', ref(0)]]))
105-
// precisa utilizar .value aqui
105+
// precisa usar .value aqui
106106
console.log(map.get('count').value)
107107
```
108108

109109
## Desestruturar Estado Reativo
110110

111-
Quando queremos usar algumas propriedades do grande objeto reativo, pode ser tentador usar [ES6 desestruturação](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment) para obter as propriedades que desejamos:
111+
Quando queremos usar algumas propriedades do grande objeto reativo, pode ser tentador usar [desestruturação do ES6](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment) para obter as propriedades que desejamos:
112112

113113
```js
114114
import { reactive } from 'vue'
115115

116116
const book = reactive({
117117
author: 'Equipe Vue',
118118
year: '2020',
119-
title: 'Guia para Vue 3',
120-
description: 'Você está lendo está documentação agora ;)',
119+
title: 'Guia do Vue 3',
120+
description: 'Você está lendo esta documentação agora ;)',
121121
price: 'grátis'
122122
})
123123

@@ -130,24 +130,24 @@ Infelizmente, com tal desestruturação, a reatividade para ambas as propriedade
130130
import { reactive, toRefs } from 'vue'
131131

132132
const book = reactive({
133-
author: 'Vue Team',
133+
author: 'Equipe Vue',
134134
year: '2020',
135-
title: 'Vue 3 Guide',
136-
description: 'You are reading this book right now ;)',
137-
price: 'free'
135+
title: 'Guia do Vue 3',
136+
description: 'Você está lendo esta documentação agora ;)',
137+
price: 'grátis'
138138
})
139139

140140
let { author, title } = toRefs(book)
141141

142-
title.value = 'Guia detalhado do Vue 3' // precisamos usar .value porque o título é uma referência agora
142+
title.value = 'Guia detalhado do Vue 3' // precisamos usar .value porque `title` é uma `ref` agora
143143
console.log(book.title) // 'Guia detalhado do Vue 3'
144144
```
145145

146-
Você pode aprender mais sobre `refs` na seção [Refs API](../api/refs-api.html#ref)
146+
Você pode aprender mais sobre `refs` na seção [API de Refs](../api/refs-api.html#ref)
147147

148-
## Evite a Mutação de Objetos Reativos com `readonly`
148+
## Evite Mutar Objetos Reativos com `readonly`
149149

150-
Às vezes, queremos rastrear as alterações do objeto reativo (`ref` ou` reactive`), mas também queremos evitar alterá-la de um determinado local do aplicativo. Por exemplo, quando temos um objeto reativo [provided](component-give-inject.html), queremos evitar a sua mutação onde ele é injetado. Para fazer isso, podemos criar um proxy somente leitura (readonly) para o objeto original:
150+
Às vezes, queremos rastrear as alterações do objeto reativo (`ref` ou` reactive`), mas também queremos evitar alterá-lo de um determinado local do aplicativo. Por exemplo, quando temos um objeto reativo [provido](component-provide-inject.html), queremos evitar a sua mutação onde ele é injetado. Para fazer isso, podemos criar um _proxy_ somente leitura (readonly) para o objeto original:
151151

152152
```js
153153
import { reactive, readonly } from 'vue'

0 commit comments

Comments
 (0)