Skip to content

vue 计算属性

基础示例

模板中的表达式虽然方便,但也只能用来做简单的操作。如果在模板中写太多逻辑,会让模板变得臃肿,难以维护。比如说,我们有这样一个包含嵌套数组的对象:

js
const author = reactive({
  name: "John Doe",
  books: [
    "Vue 2 - Advanced Guide",
    "Vue 3 - Basic Guide",
    "Vue 4 - The Mystery",
  ],
});

我们想根据 author 是否已有一些书籍来展示不同的信息:

vue
<p>Has published books:</p>
<span>{{ author.books.length > 0 ? 'Yes' : 'No' }}</span>

这里的模板看起来有些复杂。我们必须认真看好一会儿才能明白它的计算依赖于 author.books。更重要的是,如果在模板中需要不止一次这样的计算,我们可不想将这样的代码在模板里重复好多遍。

因此我们推荐使用计算属性来描述依赖响应式状态的复杂逻辑。这是重构后的示例:

vue
<script setup>
import { reactive, computed } from "vue";

const author = reactive({
  name: "John Doe",
  books: [
    "Vue 2 - Advanced Guide",
    "Vue 3 - Basic Guide",
    "Vue 4 - The Mystery",
  ],
});

// 一个计算属性 ref
const publishedBooksMessage = computed(() => {
  return author.books.length > 0 ? "Yes" : "No";
});
</script>

<template>
  <p>Has published books:</p>
  <span>{{ publishedBooksMessage }}</span>
</template>

我们在这里定义了一个计算属性 publishedBooksMessagecomputed() 方法期望接收一个 getter 函数,返回值为一个计算属性 ref。和其他一般的 ref 类似,你可以通过 publishedBooksMessage.value 访问计算结果。计算属性 ref 也会在模板中自动解包,因此在模板表达式中引用时无需添加 .value

Vue 的计算属性会自动追踪响应式依赖。它会检测到 publishedBooksMessage 依赖于 author.books,所以当 author.books 改变时,任何依赖于 publishedBooksMessage 的绑定都会同时更新。

计算属性缓存 vs 方法

你可能注意到我们在表达式中像这样调用一个函数也会获得和计算属性相同的结果:

vue
<p>{{ calculateBooksMessage() }}</p>
js
// 组件中
function calculateBooksMessage() {
  return author.books.length > 0 ? "Yes" : "No";
}

若我们将同样的函数定义为一个方法而不是计算属性,两种方式在结果上确实是完全相同的,然而,不同之处在于计算属性值会基于其响应式依赖被缓存。一个计算属性仅会在其响应式依赖更新时才重新计算。这意味着只要 author.books 不改变,无论多少次访问 publishedBooksMessage 都会立即返回先前的计算结果,而不用重复执行 getter 函数。

这也解释了为什么下面的计算属性永远不会更新,因为 Date.now() 并不是一个响应式依赖:

js
const now = computed(() => Date.now());

相比之下,方法调用总是会在重渲染发生时再次执行函数。

为什么需要缓存呢?想象一下我们有一个非常耗性能的计算属性 list,需要循环一个巨大的数组并做许多计算逻辑,并且可能也有其他计算属性依赖于 list。没有缓存的话,我们会重复执行非常多次 list 的 getter,然而这实际上没有必要!如果你确定不需要缓存,那么也可以使用方法调用。

可写计算属性

计算属性默认是只读的。当你尝试修改一个计算属性时,你会收到一个运行时警告。只在某些特殊场景中你可能才需要用到“可写”的属性,你可以通过同时提供 getter 和 setter 来创建:

vue
<script setup>
import { ref, computed } from "vue";

const firstName = ref("John");
const lastName = ref("Doe");

const fullName = computed({
  // getter
  get() {
    return firstName.value + " " + lastName.value;
  },
  // setter
  set(newValue) {
    // 注意:我们这里使用的是解构赋值语法
    [firstName.value, lastName.value] = newValue.split(" ");
  },
});
</script>

现在当你再运行 fullName.value = 'John Doe' 时,setter 会被调用而 firstNamelastName 会随之更新。

最佳实践

Getter 不应有副作用

计算属性的 getter 应只做计算而没有任何其他的副作用,这一点非常重要,请务必牢记。举例来说,不要在 getter 中做异步请求或者更改 DOM!一个计算属性的声明中描述的是如何根据其他值派生一个值。因此 getter 的职责应该仅为计算和返回该值。在之后的指引中我们会讨论如何使用侦听器根据其他响应式状态的变更来创建副作用。

避免直接修改计算属性值

从计算属性返回的值是派生状态。可以把它看作是一个“临时快照”,每当源状态发生变化时,就会创建一个新的快照。更改快照是没有意义的,因此计算属性的返回值应该被视为只读的,并且永远不应该被更改——应该更新它所依赖的源状态以触发新的计算。

案例

computed 函数:

  • 与 computed 配置功能一致
  • 只有 getter
  • 有 getter 和 setter

计算属性

目标:一个数据,依赖另外一些数据计算而来的结果

需求:

  • 需求:根据出生日期计算年龄
vue
<script setup>
import { ref, computed } from "vue";

const birth_day = ref(0);

// 计算属性:
// 场景:一个变量的值,需要用另外变量计算而得来
// 注意 2: 函数内变量变化,会自动重新计算结果返回
const age = computed(() => {
  let year = new Date().getFullYear() - birth_day.value;
  return year < 0 ? "-----" : year;
});
</script>

<template>
  <div>
    请输入你的出生年份:<label
      ><input type="text" v-model.number="birth_day"
    /></label>
  </div>
  <div>你今年已经:{{ age }} 岁了</div>
</template>

<style scoped></style>

注意:计算属性也是 vue 数据变量,所以不要和 data 里重名,用法和 data 相同

总结:一个数据,依赖另外一些数据计算而来的结果

完整写法

目标:计算属性也是变量,如果想要直接赋值,需要使用完整写法

页面准备输入框

vue
<script setup>
import { ref, computed } from "vue";

const birth_day = ref(0);

/*
计算属性
1. computed 函数:
  与 computed 配置功能一致
  只有 getter
  有 getter 和 setter
*/

const age = computed({
  get: () => {
    let year = new Date().getFullYear() - birth_day.value;
    return year < 0 ? "-----" : year;
  },
  set: (val) => {
    birth_day.value = new Date().getFullYear() - val;
  },
});
</script>

<template>
  <div>
    请输入你的出生年份:<label
      ><input type="text" v-model.number="birth_day"
    /></label>
  </div>
  <div>你今年已经:{{ age }} 岁了</div>
</template>

<style scoped></style>

总结:想要给计算属性赋值,需要使用 set 方法