angular-docs-cn/modules/@angular/compiler
Victor Berchet bf8eb41248 feat(compiler): introduce `<ng-template>`, deprecate `<template>` and `template` attribute
The rationale of this change is to improve the inter-operability with web
components that might make use of the `<template>` tag.

DEPRECATION

The template tags and template attribute are deprecated:

    <template ngFor [ngFor]=items let-item><li>...</li></template>
    <li template="ngFor: let item of items">...</li>

should be rewritten as:

    <ng-template ngFor [ngFor]=items let-item><li>...</li></ng-template>

Note that they still be supported in 4.x with a deprecartion warning in
development mode.

MIGRATION

- `template` tags (or elements with a `template` attribute) should be rewritten
as a `ng-template` tag,
- `ng-content` selectors should be updated to referto a `ng-template` where they
use to refer to a template: `<ng-content selector="template[attr]">` should be
rewritten as `<ng-content selector="ng-template[attr]">`
- if you consume a component relying on your templates being actual `template`
elements (that is they include a `<ng-content selector="template[attr]">`). You
should  still migrate to `ng-template` and make use of `ngProjectAs` to override
the way `ng-content` sees the template:
`<ng-template projectAs="template[attr]">`
- while `template` elements are deprecated in 4.x they continue to work.
2017-02-23 20:03:16 -08:00
..
src feat(compiler): introduce `<ng-template>`, deprecate `<template>` and `template` attribute 2017-02-23 20:03:16 -08:00
test feat(compiler): introduce `<ng-template>`, deprecate `<template>` and `template` attribute 2017-02-23 20:03:16 -08:00
testing refactor(core): enable new animations dsl 2017-02-23 13:59:16 -08:00
.babelrc-testing perf: distrubute smaller bundled code and include es2015 bundle 2017-02-21 20:48:55 -08:00
index.ts perf: distrubute smaller bundled code and include es2015 bundle 2017-02-21 20:48:55 -08:00
package.json perf: distrubute smaller bundled code and include es2015 bundle 2017-02-21 20:48:55 -08:00
rollup-umd.config.js perf: distrubute smaller bundled code and include es2015 bundle 2017-02-21 20:48:55 -08:00
tsconfig-build.json perf: distrubute smaller bundled code and include es2015 bundle 2017-02-21 20:48:55 -08:00
tsconfig-es5.json perf: distrubute smaller bundled code and include es2015 bundle 2017-02-21 20:48:55 -08:00
tsconfig-testing.json build: resolve review comments on flat modules PR and fix more bugs (#14660) 2017-02-23 16:39:44 -08:00