绑定 HTML Class

Watch a free video lesson on Vue School

对象语法

我们可以传给 v-bind:class 一个对象,以动态地切换 class:

  1. <div v-bind:class="{ active: isActive }"></div>

上面的语法表示 active 这个 class 存在与否将取决于数据属性 isActivetruthiness

你可以在对象中传入更多属性来动态切换多个 class。此外,v-bind:class 指令也可以与普通的 class 属性共存。当有如下模板:

  1. <div
  2. class="static"
  3. v-bind:class="{ active: isActive, 'text-danger': hasError }"
  4. ></div>

和如下 data:

  1. data: {
  2. isActive: true,
  3. hasError: false
  4. }

结果渲染为:

  1. <div class="static active"></div>

isActive 或者 hasError 变化时,class 列表将相应地更新。例如,如果 hasError 的值为 true,class 列表将变为 "static active text-danger"

绑定的数据对象不必内联定义在模板里:

  1. <div v-bind:class="classObject"></div>
  1. data: {
  2. classObject: {
  3. active: true,
  4. 'text-danger': false
  5. }
  6. }

渲染的结果和上面一样。我们也可以在这里绑定一个返回对象的计算属性。这是一个常用且强大的模式:

  1. <div v-bind:class="classObject"></div>
  1. data: {
  2. isActive: true,
  3. error: null
  4. },
  5. computed: {
  6. classObject: function () {
  7. return {
  8. active: this.isActive && !this.error,
  9. 'text-danger': this.error && this.error.type === 'fatal'
  10. }
  11. }
  12. }

数组语法

我们可以把一个数组传给 v-bind:class,以应用一个 class 列表:

  1. <div v-bind:class="[activeClass, errorClass]"></div>
  1. data: {
  2. activeClass: 'active',
  3. errorClass: 'text-danger'
  4. }

渲染为:

  1. <div class="active text-danger"></div>

如果你也想根据条件切换列表中的 class,可以用三元表达式:

  1. <div v-bind:class="[isActive ? activeClass : '', errorClass]"></div>

这样写将始终添加 errorClass,但是只有在 isActive 是 true[1] 时才添加 activeClass

不过,当有多个条件 class 时这样写有些繁琐。所以在数组语法中也可以使用对象语法:

  1. <div v-bind:class="[{ active: isActive }, errorClass]"></div>

用在组件上

这个章节假设你已经对 Vue 组件有一定的了解。当然你也可以先跳过这里,稍后再回过头来看。

当在一个自定义组件上使用 class 属性时,这些类将被添加到该组件的根元素上面。这个元素上已经存在的类不会被覆盖。

例如,如果你声明了这个组件:

  1. Vue.component('my-component', {
  2. template: '<p class="foo bar">Hi</p>'
  3. })

然后在使用它的时候添加一些 class:

  1. <my-component class="baz boo"></my-component>

HTML 将被渲染为:

  1. <p class="foo bar baz boo">Hi</p>

对于带数据绑定 class 也同样适用:

  1. <my-component v-bind:class="{ active: isActive }"></my-component>

isActive 为 true[1] 时,HTML 将被渲染成为:

  1. <p class="foo bar active">Hi</p>