You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/guide/reactivity-fundamentals.md
+26-26Lines changed: 26 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# Fundamentos de Reatividade
1
+
# Fundamentos da Reatividade
2
2
3
-
## Declaração de Estado Reativo
3
+
## Declarando Estado Reativo
4
4
5
5
Para criar um estado reativo a partir de um objeto JavaScript, podemos usar o método `reactive`:
6
6
@@ -13,17 +13,17 @@ const state = reactive({
13
13
})
14
14
```
15
15
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.
17
17
18
18
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.
19
19
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.
21
21
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)
23
23
24
-
## Criação de Valores Reativos Autônomos como `refs`
24
+
## Criação de Valores Reativos Avulsos como `refs`
25
25
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`:
27
27
28
28
```js
29
29
import { ref } from'vue'
@@ -45,13 +45,13 @@ console.log(count.value) // 1
45
45
46
46
### Ref Desempacotada
47
47
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_:
@@ -68,7 +68,7 @@ Quando um ref é retornado como uma propriedade no contexto de renderização (o
68
68
</script>
69
69
```
70
70
71
-
### Acesso em objetos Reativos
71
+
### Acesso em Objetos Reativos
72
72
73
73
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:
74
74
@@ -84,7 +84,7 @@ state.count = 1
84
84
console.log(count.value) // 1
85
85
```
86
86
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:
88
88
89
89
```js
90
90
constotherCount=ref(2)
@@ -94,30 +94,30 @@ console.log(state.count) // 2
94
94
console.log(count.value) // 1
95
95
```
96
96
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):
98
98
99
99
```js
100
-
constbooks=reactive([ref('Vue 3 Guide')])
101
-
// precisa utilizar .value aqui
100
+
constbooks=reactive([ref('Guia do Vue 3')])
101
+
// precisa usar .value aqui
102
102
console.log(books[0].value)
103
103
104
104
constmap=reactive(newMap([['count', ref(0)]]))
105
-
// precisa utilizar .value aqui
105
+
// precisa usar .value aqui
106
106
console.log(map.get('count').value)
107
107
```
108
108
109
109
## Desestruturar Estado Reativo
110
110
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:
112
112
113
113
```js
114
114
import { reactive } from'vue'
115
115
116
116
constbook=reactive({
117
117
author:'Equipe Vue',
118
118
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 ;)',
121
121
price:'grátis'
122
122
})
123
123
@@ -130,24 +130,24 @@ Infelizmente, com tal desestruturação, a reatividade para ambas as propriedade
130
130
import { reactive, toRefs } from'vue'
131
131
132
132
constbook=reactive({
133
-
author:'Vue Team',
133
+
author:'Equipe Vue',
134
134
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'
138
138
})
139
139
140
140
let { author, title } =toRefs(book)
141
141
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
143
143
console.log(book.title) // 'Guia detalhado do Vue 3'
144
144
```
145
145
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)
147
147
148
-
## Evite a Mutação de Objetos Reativos com `readonly`
148
+
## Evite Mutar Objetos Reativos com `readonly`
149
149
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:
0 commit comments