exported from <a href='../directives'>angular2/directives</a>
defined in <a href="https://github.com/angular/angular/tree/2.0.0-alpha.32/modules/angular2/src/directives/ng_if.ts#L3-L48">angular2/src/directives/ng_if.ts (line 3)</a>
:markdown
Removes or recreates a portion of the DOM tree based on an {expression}.
If the expression assigned to `ng-if` evaluates to a false value then the element
is removed from the DOM, otherwise a clone of the element is reinserted into the DOM.
# Example:
```
<div *ng-if="errorCount > 0" class="error">
<!-- Error message displayed when the errorCount property on the current context is greater