Связывание CSS-классов

Использование объектов

Для динамической установки или удаления CSS-классов можно передавать объект в директиву v-bind:class:

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

Запись выше означает, что наличие класса active будет определяться истинностью параметра isActive.

Таким образом можно управлять несколькими классами, добавляя в объект другие поля. Кроме того, v-bind:class можно использовать совместно с обычным атрибутом class:

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

При использовании таких данных:

data: {
  isActive: true,
  hasError: false
}

В результате получится:

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

Список классов элемента обновится при изменении isActive или hasError. Например, если hasError станет true, то значением атрибута class будет "static active text-danger".

Используемый объект необязательно указывать прямо в шаблоне:

<div v-bind:class="classObject"></div>

data: {
  classObject: {
    active: true,
    'text-danger': false
  }
}

Результат будет таким же. Можно также использовать и вычисляемые свойства, которые возвращают объект — это очень распространённый и мощный приём:

<div v-bind:class="classObject"></div>

data: {
  isActive: true,
  error: null
},
computed: {
  classObject: function () {
    return {
      active: this.isActive && !this.error,
      'text-danger': this.error && this.error.type === 'fatal'
    }
  }
}

Использование массивов

В v-bind:class можно передать и массив:

<div v-bind:class="[activeClass, errorClass]"></div>

data: {
  activeClass: 'active',
  errorClass: 'text-danger'
}

В результате получим:

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

Для переключения классов в массиве, в зависимости от некоторого условия, можно использовать условный оператор в тернарной форме:

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

В этом случае errorClass будет применён к элементу всегда, а activeClass — только в случае истинности isActive.

Однако, такая запись становится слегка громоздкой, особенно если есть несколько классов, задаваемых по условию. Но можно использовать и смешанный синтаксис:

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

Использование с компонентами

При использовании атрибута class на пользовательском компоненте, классы будут добавлены к его корневому элементу. Собственные классы элемента при этом не будут потеряны.

Возьмём, к примеру, такой компонент:

Vue.component('my-component', {
  template: '<p class="foo bar">Привет</p>'
})

Если указать дополнительные классы на компоненте:

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

В результате отрисовки получим:

<p class="foo bar baz boo">Привет</p>

То же самое справедливо для связывания классов с данными:

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

Если isActive истинно, результирующий HTML будет:

<p class="foo bar active">Привет</p>