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

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

Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Аргументы

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

Анимации

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

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

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

Нажмите здесь, чтобы узнать больше о шагах, участвующих в анимации.

Примеры

Базовый

Анимации

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

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