Улучшить эту документацию Просмотреть исходный код ngClass

директива в модуле ng

Директива ngClass позволяет динамически задавать CSS-классы HTML-элементу, привязывая выражение, представляющее все добавляемые классы.

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

Если выражение вычисляется в строку, строка должна содержать один или несколько имен классов, разделенных пробелами.
Если выражение вычисляется в объект, то для каждой пары ключ-значение объекта с истинным значением соответствующий ключ используется как имя класса.
Если выражение вычисляется в массив, каждый элемент массива должен быть либо строкой, как в типе 1, либо объектом, как в типе 2. Это означает, что вы можете смешивать строки и объекты в массиве, чтобы получить больший контроль над отображаемыми CSS-классами. Пример этого показан ниже в коде.

Директива не будет добавлять дублирующиеся классы, если определенный класс уже был задан.

При изменении выражения ранее добавленные классы удаляются, а затем добавляются новые классы.

Известные проблемы

Не следует использовать интерполяцию в значении атрибута class, при использовании директивы ngClass на том же элементе. Дополнительную информацию см. здесь.

Информация о директиве

Эта директива выполняется на уровне приоритета 0.

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

в качестве атрибута:

<ANY
  ng-class="expression">
...
</ANY>

в качестве CSS-класса:

<ANY class="ng-class: expression;"> ... </ANY>

Анимации

Анимация	Происходит
addClass	непосредственно перед применением класса к элементу
removeClass	непосредственно перед удалением класса из элемента

Нажмите здесь, чтобы узнать больше о процессах анимации.

Аргументы

Параметр	Тип	Подробности
ngClass	`expression`	Выражение для вычисления. Результатом вычисления может быть строка, представляющая имена классов, разделенных пробелами, массив или карта имен классов с логическими значениями. В случае карты имена свойств, значения которых истинны, будут добавлены в качестве CSS-классов к элементу.

Пример, демонстрирующий основные привязки с помощью директивы ngClass.

Анимации

В примере ниже показано, как выполнять анимации с помощью ngClass.

ngClass и существующие CSS3 переходы/анимации

Директива ngClass по-прежнему поддерживает CSS3 переходы/анимации, даже если они не следуют структуре именования ngAnimate. При анимации ngAnimate добавит дополнительные CSS-классы для отслеживания начала и конца анимации, но это не повлияет на существующие CSS-переходы элемента. Чтобы понять, что происходит во время анимации на основе класса, обязательно ознакомьтесь с пошаговыми инструкциями $animate.addClass и $animate.removeClass.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.5.11/docs/api/ng/directive/ngClass