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

Директива ngIf удаляет или воссоздаёт часть DOM-дерева на основе выражения {expression}. Если выражение, присвоенное ngIf, имеет ложное значение, то элемент удаляется из DOM; в противном случае в DOM вставляется копия элемента.

ngIf отличается от ngShow и ngHide тем, что ngIf полностью удаляет и воссоздаёт элемент в DOM, а не меняет его видимость с помощью свойства CSS display. Часто эта разница значима, когда используются CSS-селекторы, которые зависят от положения элемента в DOM, такие как псевдоклассы :first-child или :last-child.

Обратите внимание, что при удалении элемента с помощью ngIf его область видимости уничтожается, а при восстановлении создаётся новая. Область видимости, созданная внутри ngIf, наследует свойства от родительской области видимости с помощью прототипного наследования. Важное следствие этого заключается в том, что если ngModel используется внутри ngIf для привязки к примитиву JavaScript, определённому в родительской области видимости, любые изменения, внесённые в переменную в дочерней области видимости, перепишут (скрывают) значение в родительской области видимости.

Также, ngIf воссоздаёт элементы, используя их скомпилированное состояние. Примером такого поведения является ситуация, когда атрибут класса элемента изменяется непосредственно после компиляции, используя, например, метод .addClass() jQuery, а затем элемент удаляется. Когда ngIf воссоздаёт элемент, добавленный класс будет потерян, поскольку для регенерации элемента используется исходное скомпилированное состояние.

Кроме того, для анимации эффектов enter и leave можно использовать модуль ngAnimate.