angular-cn/modules/angular2/docs/cheatsheet/built-in-directives.md
Tobias Bosch d2efac18ed feat(core): separate refs from vars.
Introduces `ref-` to give a name to an element or a directive (also works for `<template>` elements), and `let-` to introduce an input variable for a `<template>` element.

BREAKING CHANGE:
- `#...` now always means `ref-`.
- `<template #abc>` now defines a reference to the TemplateRef, instead of an input variable used inside of the template.
- `#...` inside of a *ngIf, … directives is deprecated.
  Use `let …` instead.
- `var-...` is deprecated. Replace with `let-...` for `<template>` elements and `ref-` for non `<template>` elements.

Closes #7158

Closes #8264
2016-04-28 01:13:40 +00:00

1.3 KiB

@cheatsheetSection Built-in directives @cheatsheetIndex 2 @description {@target ts}import {NgIf, ...} from 'angular2/common';{@endtarget} {@target js}Available from the ng.common namespace{@endtarget} {@target dart}Available using platform_directives in pubspec{@endtarget}

@cheatsheetItem syntax: <section *ngIf="showSection">|*ngIf description: Removes or recreates a portion of the DOM tree based on the showSection expression.

@cheatsheetItem syntax: <li *ngFor="let item of list">|*ngFor description: Turns the li element and its contents into a template, and uses that to instantiate a view for each item in list.

@cheatsheetItem syntax: `<div [ngSwitch]="conditionExpression"> <template [ngSwitchWhen]="case1Exp">... ... ...

`|`[ngSwitch]`|`[ngSwitchWhen]`|`ngSwitchWhen`|`ngSwitchDefault` description: Conditionally swaps the contents of the div by selecting one of the embedded templates based on the current value of conditionExpression.

@cheatsheetItem syntax: <div [ngClass]="{active: isActive, disabled: isDisabled}">|[ngClass] description: Binds the presence of CSS classes on the element to the truthiness of the associated map values. The right-hand side expression should return {class-name: true/false} map.