1 |
49598
|
stefanos.g
|
/**
|
2 |
|
|
* @license
|
3 |
|
|
* Copyright Google Inc. All Rights Reserved.
|
4 |
|
|
*
|
5 |
|
|
* Use of this source code is governed by an MIT-style license that can be
|
6 |
|
|
* found in the LICENSE file at https://angular.io/license
|
7 |
|
|
*/
|
8 |
|
|
import { ElementRef } from './element_ref';
|
9 |
|
|
import { EmbeddedViewRef } from './view_ref';
|
10 |
|
|
/**
|
11 |
|
|
* Represents an Embedded Template that can be used to instantiate Embedded Views.
|
12 |
|
|
*
|
13 |
|
|
* You can access a `TemplateRef`, in two ways. Via a directive placed on a `<ng-template>` element
|
14 |
|
|
* (or directive prefixed with `*`) and have the `TemplateRef` for this Embedded View injected into
|
15 |
|
|
* the constructor of the directive using the `TemplateRef` Token. Alternatively you can query for
|
16 |
|
|
* the `TemplateRef` from a Component or a Directive via {@link Query}.
|
17 |
|
|
*
|
18 |
|
|
* To instantiate Embedded Views based on a Template, use
|
19 |
|
|
* {@link ViewContainerRef#createEmbeddedView}, which will create the View and attach it to the
|
20 |
|
|
* View Container.
|
21 |
|
|
* @stable
|
22 |
|
|
*/
|
23 |
|
|
export declare abstract class TemplateRef<C> {
|
24 |
|
|
/**
|
25 |
|
|
* The location in the View where the Embedded View logically belongs to.
|
26 |
|
|
*
|
27 |
|
|
* The data-binding and injection contexts of Embedded Views created from this `TemplateRef`
|
28 |
|
|
* inherit from the contexts of this location.
|
29 |
|
|
*
|
30 |
|
|
* Typically new Embedded Views are attached to the View Container of this location, but in
|
31 |
|
|
* advanced use-cases, the View can be attached to a different container while keeping the
|
32 |
|
|
* data-binding and injection context from the original location.
|
33 |
|
|
*
|
34 |
|
|
*/
|
35 |
|
|
readonly abstract elementRef: ElementRef;
|
36 |
|
|
abstract createEmbeddedView(context: C): EmbeddedViewRef<C>;
|
37 |
|
|
}
|