#声明响应式状态

要为 JavaScript 对象创建响应式状态，可以使用 reactive 方法：

1. import { reactive } from 'vue'
4. // 响应式状态
5. const state = reactive({
6. count: 0
7. })

reactive 相当于 Vue 2.x 中的 Vue.observable() API ，为避免与 RxJS 中的 observables 混淆因此对其重命名。该 API 返回一个响应式的对象状态。该响应式转换是“深度转换”——它会影响嵌套对象传递的所有 property。

Vue 中响应式状态的基本用例是我们可以在渲染期间使用它。因为依赖跟踪的关系，当响应式状态改变时视图会自动更新。

这就是 Vue 响应性系统的本质。当从组件中的 data() 返回一个对象时，它在内部交由 reactive() 使其成为响应式对象。模板会被编译成能够使用这些响应式 property 的渲染函数。

在响应性基础 API 章节你可以学习更多关于 reactive 的内容。

#创建独立的响应式值作为 refs

想象一下，我们有一个独立的原始值 (例如，一个字符串)，我们想让它变成响应式的。当然，我们可以创建一个拥有相同字符串 property 的对象，并将其传递给 reactive。Vue 为我们提供了一个可以做相同事情的方法 ——ref：

1. import { ref } from 'vue'
4. const count = ref(0)

ref 会返回一个可变的响应式对象，该对象作为它的内部值——一个响应式的引用，这就是名称的来源。此对象只包含一个名为 value 的 property ：

1. import { ref } from 'vue'
4. const count = ref(0)
5. console.log(count.value) // 0
8. count.value++
9. console.log(count.value) // 1

#Ref 展开

当 ref 作为渲染上下文 (从 setup() 中返回的对象) 上的 property 返回并可以在模板中被访问时，它将自动展开为内部值。不需要在模板中追加 .value：

1. <template>
2. <div>
3. <span>{{ count }}</span>
4. <button @click="count ++">Increment count</button>
5. </div>
6. </template>
9. <script>
10. import { ref } from 'vue'
11. export default {
12. setup() {
13. const count = ref(0)
14. return {
15. count
16. }
17. }
18. }
19. </script>

#访问响应式对象

当 ref 作为响应式对象的 property 被访问或更改时，为使其行为类似于普通 property，它会自动展开内部值：

1. const count = ref(0)
2. const state = reactive({
3. count
4. })
7. console.log(state.count) // 0
10. state.count = 1
11. console.log(count.value) // 1

如果将新的 ref 赋值给现有 ref 的 property，将会替换旧的 ref：

1. const otherCount = ref(2)
4. state.count = otherCount
5. console.log(state.count) // 2
6. console.log(count.value) // 1

Ref 展开仅发生在被响应式 Object 嵌套的时候。当从 Array 或原生集合类型如 Map访问 ref 时，不会进行展开：

1. const books = reactive([ref('Vue 3 Guide')])
2. // 这里需要 .value
3. console.log(books[0].value)
6. const map = reactive(new Map([['count', ref(0)]]))
7. // 这里需要 .value
8. console.log(map.get('count').value)

#响应式状态解构

当我们想使用大型响应式对象的一些 property 时，可能很想使用 ES6 解构来获取我们想要的 property：

1. import { reactive } from 'vue'
4. const book = reactive({
5. author: 'Vue Team',
6. year: '2020',
7. title: 'Vue 3 Guide',
8. description: 'You are reading this book right now ;)',
9. price: 'free'
10. })
13. let { author, title } = book

遗憾的是，使用解构的两个 property 的响应性都会丢失。对于这种情况，我们需要将我们的响应式对象转换为一组 ref。这些 ref 将保留与源对象的响应式关联：

1. import { reactive, toRefs } from 'vue'
4. const book = reactive({
5. author: 'Vue Team',
6. year: '2020',
7. title: 'Vue 3 Guide',
8. description: 'You are reading this book right now ;)',
9. price: 'free'
10. })
13. let { author, title } = toRefs(book)
16. title.value = 'Vue 3 Detailed Guide' // 我们需要使用 .value 作为标题，现在是 ref
17. console.log(book.title) // 'Vue 3 Detailed Guide'

你可以在 Refs API 部分中了解更多有关 refs 的信息

#使用 readonly 防止更改响应式对象

有时我们想跟踪响应式对象 (ref 或 reactive) 的变化，但我们也希望防止在应用程序的某个位置更改它。例如，当我们有一个被 provide 的响应式对象时，我们不想让它在注入的时候被改变。为此，我们可以基于原始对象创建一个只读的 Proxy 对象：

1. import { reactive, readonly } from 'vue'
4. const original = reactive({ count: 0 })
7. const copy = readonly(original)
10. // 在copy上转换original 会触发侦听器依赖
13. original.count++
16. // 转换copy 将导失败并导致警告
17. copy.count++ // 警告: "Set operation on key 'count' failed: target is readonly."