Skip to content

v-bind 属性绑定

数据绑定的一个常见需求场景是操纵元素的 CSS class 列表和内联样式。因为 classstyle 都是 attribute,我们可以和其他 attribute 一样使用 v-bind 将它们和动态的字符串绑定。但是,在处理比较复杂的绑定时,通过拼接生成字符串是麻烦且易出错的。因此,Vue 专门为 classstylev-bind 用法提供了特殊的功能增强。除了字符串外,表达式的值也可以是对象或数组。

绑定 HTML class

绑定对象

我们可以给 :class (v-bind:class 的缩写) 传递一个对象来动态切换 class:

vue
<div :class="{ active: isActive }"></div>

上面的语法表示 active 是否存在取决于数据属性 isActive真假值

你可以在对象中写多个字段来操作多个 class。此外,:class 指令也可以和一般的 class attribute 共存。举例来说,下面这样的状态:

js
const isActive = ref(true);
const hasError = ref(false);

配合以下模板:

vue
<div
  class="static"
  :class="{ active: isActive, 'text-danger': hasError }"
></div>

渲染的结果会是:

vue
<div class="static active"></div>

isActive 或者 hasError 改变时,class 列表会随之更新。举例来说,如果 hasError 变为 true,class 列表也会变成 "static active text-danger"

绑定的对象并不一定需要写成内联字面量的形式,也可以直接绑定一个对象:

js
const classObject = reactive({
  active: true,
  "text-danger": false,
});
vue
<div :class="classObject"></div>

这也会渲染出相同的结果。我们也可以绑定一个返回对象的 计算属性。这是一个常见且很有用的技巧:

js
const isActive = ref(true);
const error = ref(null);

const classObject = computed(() => ({
  active: isActive.value && !error.value,
  "text-danger": error.value && error.value.type === "fatal",
}));
vue
<div :class="classObject"></div>

绑定数组

我们可以给 :class 绑定一个数组来渲染多个 CSS class:

js
const activeClass = ref("active");
const errorClass = ref("text-danger");
vue
<div :class="[activeClass, errorClass]"></div>

渲染的结果是:

vue
<div class="active text-danger"></div>

如果你也想在数组中有条件地渲染某个 class,你可以使用三元表达式:

vue
<div :class="[isActive ? activeClass : '', errorClass]"></div>

errorClass 会一直存在,但 activeClass 只会在 isActive 为真时才存在。

然而,这可能在有多个依赖条件的 class 时会有些冗长。因此也可以在数组中嵌套对象:

vue
<div :class="[{ active: isActive }, errorClass]"></div>

绑定内联样式

绑定对象

:style 支持绑定 JavaScript 对象值,对应的是 HTML 元素的 style 属性

js
const activeColor = ref("red");
const fontSize = ref(30);
vue
<div :style="{ color: activeColor, fontSize: fontSize + 'px' }"></div>

尽管推荐使用 camelCase,但 :style 也支持 kebab-cased 形式的 CSS 属性 key (对应其 CSS 中的实际名称),例如:

vue
<div :style="{ 'font-size': fontSize + 'px' }"></div>

直接绑定一个样式对象通常是一个好主意,这样可以使模板更加简洁:

js
const styleObject = reactive({
  color: "red",
  fontSize: "13px",
});
vue
<div :style="styleObject"></div>

同样的,如果样式对象需要更复杂的逻辑,也可以使用返回样式对象的计算属性。

绑定数组

我们还可以给 :style 绑定一个包含多个样式对象的数组。这些对象会被合并后渲染到同一元素上:

vue
<div :style="[baseStyles, overridingStyles]"></div>

动态样式绑定

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

const bool = ref(true);
const color_str = ref("red");
</script>

<vue>
  <div>
    <!-- 语法:
      :class="{类名:布尔值}"
      使用场景:vue 变量控制标签是否应该有类名
     -->
    <p :class="{red_str: bool}">动态 class</p>

    <!-- 动态 style 语法
      :style="{css 属性名:值}"
     -->
    <p :style="{backgroundColor: color_str}">动态 style</p>
  </div>
</vue>

<style scoped>
.red_str {
  color: red;
}
</style>