Tobias Bosch
cc0c30484f
- Rename `DirectiveMetadata` into `CompileDirectiveMetadata`, merge with `NormalizedDirectiveMetadata` and remove `ChangeDetectionMetadata` - Store change detector factories not as array but directly at the `CompiledTemplate` or the embedded template to make instantiation easier later on - Already analyze variable values and map them to `Directive.exportAs` - Keep the directive sort order as specified in the `@View()` annotation - Allow to clear the runtime cache in `StyleCompiler` and `TemplateCompiler` - Ignore `script` elements to match the semantics of the current compiler - Make all components dynamically loadable and remove the previously introduced property `@Component#dynamicLoadable` for now until we find a better option to configure this - Don’t allow to specify bindings in `@View#directives` and `@View#pipes` as this was never supported by the transformer (see below for the breaking change) BREAKING CHANGE: - don't support DI bindings in `@View#directives` and `@View@pipes` any more in preparation of integrating the new compiler. Use `@Directive#bindings` to reexport directives under a different token instead. Part of #3605 Closes #4314
115 lines
2.9 KiB
TypeScript
115 lines
2.9 KiB
TypeScript
import {ABSTRACT, CONST, Type} from 'angular2/src/core/facade/lang';
|
|
import {ViewEncapsulation} from 'angular2/src/core/render/api';
|
|
|
|
export {ViewEncapsulation} from 'angular2/src/core/render/api';
|
|
|
|
/**
|
|
* Declares the available HTML templates for an application.
|
|
*
|
|
* Each Angular component requires a single `@Component` and at least one `@View` annotation. The
|
|
* `@View` annotation specifies the HTML template to use, and lists the directives that are active
|
|
* within the template.
|
|
*
|
|
* When a component is instantiated, the template is loaded into the component's shadow root, and
|
|
* the expressions and statements in the template are evaluated against the component.
|
|
*
|
|
* For details on the `@Component` annotation, see {@link ComponentMetadata}.
|
|
*
|
|
* ## Example
|
|
*
|
|
* ```
|
|
* @Component({
|
|
* selector: 'greet'
|
|
* })
|
|
* @View({
|
|
* template: 'Hello {{name}}!',
|
|
* directives: [GreetUser, Bold]
|
|
* })
|
|
* class Greet {
|
|
* name: string;
|
|
*
|
|
* constructor() {
|
|
* this.name = 'World';
|
|
* }
|
|
* }
|
|
* ```
|
|
*/
|
|
@CONST()
|
|
export class ViewMetadata {
|
|
/**
|
|
* Specifies a template URL for an Angular component.
|
|
*
|
|
* NOTE: either `templateUrl` or `template` should be used, but not both.
|
|
*/
|
|
templateUrl: string;
|
|
|
|
/**
|
|
* Specifies an inline template for an Angular component.
|
|
*
|
|
* NOTE: either `templateUrl` or `template` should be used, but not both.
|
|
*/
|
|
template: string;
|
|
|
|
/**
|
|
* Specifies stylesheet URLs for an Angular component.
|
|
*/
|
|
styleUrls: string[];
|
|
|
|
/**
|
|
* Specifies an inline stylesheet for an Angular component.
|
|
*/
|
|
styles: string[];
|
|
|
|
/**
|
|
* Specifies a list of directives that can be used within a template.
|
|
*
|
|
* Directives must be listed explicitly to provide proper component encapsulation.
|
|
*
|
|
* ## Example
|
|
*
|
|
* ```javascript
|
|
* @Component({
|
|
* selector: 'my-component'
|
|
* })
|
|
* @View({
|
|
* directives: [NgFor]
|
|
* template: '
|
|
* <ul>
|
|
* <li *ng-for="#item of items">{{item}}</li>
|
|
* </ul>'
|
|
* })
|
|
* class MyComponent {
|
|
* }
|
|
* ```
|
|
*/
|
|
directives: Array<Type | any[]>;
|
|
|
|
pipes: Array<Type | any[]>;
|
|
|
|
/**
|
|
* Specify how the template and the styles should be encapsulated.
|
|
* The default is {@link ViewEncapsulation#Emulated `ViewEncapsulation.Emulated`} if the view
|
|
* has styles,
|
|
* otherwise {@link ViewEncapsulation#None `ViewEncapsulation.None`}.
|
|
*/
|
|
encapsulation: ViewEncapsulation;
|
|
|
|
constructor({templateUrl, template, directives, pipes, encapsulation, styles, styleUrls}: {
|
|
templateUrl?: string,
|
|
template?: string,
|
|
directives?: Array<Type | any[]>,
|
|
pipes?: Array<Type | any[]>,
|
|
encapsulation?: ViewEncapsulation,
|
|
styles?: string[],
|
|
styleUrls?: string[],
|
|
} = {}) {
|
|
this.templateUrl = templateUrl;
|
|
this.template = template;
|
|
this.styleUrls = styleUrls;
|
|
this.styles = styles;
|
|
this.directives = directives;
|
|
this.pipes = pipes;
|
|
this.encapsulation = encapsulation;
|
|
}
|
|
}
|