queries######{[key:string]:any}######設定將要注入到該指令中的一些查詢。內容查詢會在呼叫 ngAfterContentInit 回呼之前設定好。試著查詢會在呼叫 ngAfterViewInit 回呼之前設定好。 ############jit######true######如果為true，則該指令/元件將會被AOT 編譯器忽略，因此永遠只會被JIT 編譯。這個選項是為了支援未來的 Ivy 編譯器，目前還沒有效果。 ############host######{[key:string]:string}######使用一組鍵-值對，把類別的屬性對應到宿主元素的綁定（Property、Attribute 和事件）。 Angular 在變更偵測期間會自動檢查宿主 Property 綁定。如果綁定的值發生了變化，Angular 就會更新該指令的宿主元素。當 key 是宿主元素的 Property 時，這個 Property 值就會傳播到指定的 DOM 屬性。當 key 是 DOM 中的靜態 Attribute 時，這個 Attribute 值就會傳到宿主元素上指定的 Property 去。對於事件處理：###· 它的 key 就是該指令想要監聽的 DOM 事件。若要監聽全域事件，請把要監聽的目標加到事件名稱的前面。這個目標可以是 window、document 或 body。 ###· 它的 value 就是當該事件發生時要執行的語句。如果該語句傳回 false，那麼就會呼叫這個 DOM 事件的 preventDefault 函數。這個語句中可以引用局部變數 $event 來取得事件資料。 ############
|
#類型 | 說明 |
| changeDetection |
#ChangeDetectionStrategy |
當元件實例化之後，Angular 就會建立一個變更偵測器，它負責傳播組件各個綁定值的變化。此策略是下列數值之一：
· ChangeDetectionStrategy#OnPush(0) 把策略設為 CheckOnce（按需）。
· ChangeDetectionStrategy#Default(1) 把策略設定為 CheckAlways。 |
| viewProviders |
Provider[] |
#定義一組可注入對象，它們在視圖的各個子節點中可用 |
| moduleId |
string |
包含該元件的那個模組的ID。此元件必須能解析模板和樣式表中使用的相對 URL。 SystemJS 在每個模組中都導出了 __moduleName 變數。在 CommonJS 中，它可以設定為module.id。 |
| templateUrl |
string |
元件範本檔案的 URL。如果提供了它，就不要再用 template 來提供內聯模板了。 |
| template |
string |
元件的內聯模板。如果提供了它，就不要再用 templateUrl 提供模板了。 |
| styleUrls |
string[] |
一個或多個 URL，指向包含本元件 CSS 樣式表的檔案。 |
| styles |
string[] |
本元件用到的一個或多個內嵌 CSS 樣式。 |
| animations |
any[] |
一個或多個動畫 trigger() 調用，包含一些 state() 和 transition() 定義。 |
| encapsulation |
ViewEncapsulation |
供模板和 CSS 樣式使用的樣式封裝策略。取值為：
· ViewEncapsulation.ShadowDom：使用 Shadow DOM。它只在原生支援 Shadow DOM 的平台上運作。
· ViewEncapsulation.Emulated：使用墊片（shimmed) CSS 來模擬原生行為。
· ViewEncapsulation.None：使用全域 CSS，不做任何封裝。
如果沒有提供，該值就會從 CompilerOptions 中取得它。預設的編譯器選項是 ViewEncapsulation.Emulated。如果該策略設定為 ViewEncapsulation.Emulated，且該元件沒有指定 styles 或 styleUrls，就會自動切換到 ViewEncapsulation.None。 |
| interpolation |
[string, string] |
改寫預設的插值表達式起止分界符（{{ 和}}） |
| entryComponents |
Array9eecf80e40e62541f9fe709ed995e8cd |
##preserveWhitespaces | boolean | 為true 則保留，為false 則從編譯後的範本中移除可能多餘的空白字元。空白字元就是指那些能在 JavaScript 正規表示式中符合 \s 的字元。預設為 false，除非透過編譯器選項改寫了它。 |
二、 selector 选择器
可使用下列形式之一：
-
element-name： 根据元素名选取
-
[attribute]： 根据属性名选取
-
.class： 根据类名选取
-
[attribute=value]： 根据属性名和属性值选取
-
not(sub_selector)： 只有当元素不匹配子选择器 sub_selector 的时候才选取
-
selector1, selector2： 无论 selector1 还是 selector2 匹配时都选取
2.1 <span style="font-size: 18px;">element-name</span>： 根据元素名选取
@Component({
selector: 'app-element',
template: './element.component.html',
styleUrls: ['./element.component.css']
})<app-element></app-element>
2.2 <span style="font-size: 18px;">[attribute]</span>： 根据属性名选取
@Component({
selector: '[app-element]',
template: './element.component.html',
styleUrls: ['./element.component.css']
})<div app-element></div>
2.3 <span style="font-size: 18px;">.class</span>： 根据类名选取
@Component({
selector: '.app-element',
template: './element.component.html',
styleUrls: ['./element.component.css']
})<div class="app-element"></div>
三、 host: {[key:string]:string}
使用一组键-值对，把类的属性映射到宿主元素的绑定（Property、Attribute 和事件）。
Angular 在变更检测期间会自动检查宿主 Property 绑定。 如果绑定的值发生了变化，Angular 就会更新该指令的宿主元素。
- 当 key 是宿主元素的 Property 时，这个 Property 值就会传播到指定的 DOM 属性。
- 当 key 是 DOM 中的静态 Attribute 时，这个 Attribute 值就会传播到宿主元素上指定的 Property 去。
- 注意属性的值默认为变量，如果直接使用属性值，需要加字符串单引号或者双引号，变量直接在组件里定义即可
对于事件处理：
- 它的 key 就是该指令想要监听的 DOM 事件。 要想监听全局事件，请把要监听的目标添加到事件名的前面。 这个目标可以是 window、document 或 body。
- 它的 value 就是当该事件发生时要执行的语句。如果该语句返回 false，那么就会调用这个 DOM 事件的 preventDefault 函数。 这个语句中可以引用局部变量 $event 来获取事件数据。
3.1 <span style="font-size: 18px;">attribute</span> 和 <span style="font-size: 18px;">property</span>
- property：dom元素作为对象附加的内容，例如childNodes、firstChild等
- attribute：HTML标签特性是dom节点自带的属性
异同：
- 部分属性既属于 property ，又属于 attribute ，比如 id
- attribute 初始化后不会再改变； property 默认值为初始值，会随着 dom 更新
所以在 angular2 中双向绑定实现是由 dom 的 property 实现的，所以指令绑定的是 property ，但是在某些情况下 dom 不存在某个 property 比如 colspan，rowspan 等，这时想要绑定 html 标签特性需要用到 attr:
<table width="100%" border="10px solid">
<tr>
<th>Month</th>
<th>Savings</th>
</tr>
<tr>
<td [attr.colspan]=colnum>January</td>
</tr>
<tr>
<td [attr.colspan]=colnum>February</td>
</tr>
</table>
let colnum:number = 2;3.2 使用 <span style="font-size: 18px;">host</span> 绑定 <span style="font-size: 18px;">class</span>
@Component({
selector: '.app-element',
template: './element.component.html',
styleUrls: ['./element.component.css'],
host: {
'[class.default-class]': 'useDefault'
},
encapsulation: ViewEncapsulation.None // 让宿主元素也用上 element.component.css 样式。否则，默认胶囊封装避免CSS污染。
})
export class AppElementComponent {
@Input() useDefault = true;
}<div class="app-element"></div>
3.3 使用 <span style="font-size: 18px;">host</span> 绑定 <span style="font-size: 18px;">style</span>
@Component({
selector: '.app-element',
template: './element.component.html',
styleUrls: ['./element.component.css'],
host: {
'[style.background]': 'inputBackground'
}
})
export class AppElementComponent {
@Input() inputBackground = 'red';
}<div class="app-element"></div>
3.4 使用 <span style="font-size: 18px;">host</span> 绑定事件
@Component({
selector: '.app-element',
template: './element.component.html',
styleUrls: ['./element.component.css'],
host: {
'(click)': 'onClick($event)'
}
})
export class AppElementComponent {
public onClick($event) {
console.log($event);
}
}<div class="app-element"></div>
四、 encapsulation（封装）
供模板和 CSS 样式使用的样式封装策略。
4.1 Web Components
通过一种标准化的非侵入的方式封装一个组件，每个组件能组织好它自身的 HTML 结构、CSS 样式、JavaScript 代码，并且不会干扰页面上的其他元素。
Web Components 由以下四种技术组成：
- Custom Elements: 自定义元素HTML
- Templates: HTML模板
- Shadow DOM: 影子DOMHTML
- Imports: HTML导入
4.2 Shadow DOM
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Shadow DOM</title>
<style type="text/css">
.shadowroot_son {
color: #f00;
}
</style>
</head>
<body>
<p>我不在 Shadow Host内</p>
<div>Hello, world!</div>
<script>
// 影子宿主（shadow host）
var shadowHost = document.querySelector('.shadowhost');
// 创建影子根（shadow root）
var shadowRoot = shadowHost.createShadowRoot();
// 影子根作为影子树的第一个节点，其他的节点比如p节点都是它的子节点。
shadowRoot.innerHTML = '<p>我在 Shadow Host内</p>';
</script>
</body>
<html>4.3 <span style="font-size: 18px;">ViewEncapsulation</span>
ViewEncapsulation 允许设置三个可选的值：
- ViewEncapsulation.Emulated: 无 Shadow DOM，但是通过 Angular 提供的样式包装机制来封装组件，使得组件的样式不受外部影响。这是 Angular 的默认设置。
- ViewEncapsulation.ShadowDom: 使用原生的 Shadow DOM 特性
- ViewEncapsulation.None: 无 Shadow DOM，并且也无样式包装
4.3.1 ViewEncapsulation.None
import { Component, ViewEncapsulation } from '@angular/core';
@Component({
selector: 'my-app',
template: `
<h4>Welcome to Angular World</h4>
<p class="greet">Hello {{name}}</p>
`,
styles: [`
.greet {
background: #369;
color: white;
}
`],
encapsulation: ViewEncapsulation.None // None | Emulated | ShadowDom
})
export class AppComponent {
name: string = 'Semlinker';
}ViewEncapsulation.None 设置的结果是没有 Shadow DOM，并且所有的样式都应用到整个 document，换句话说，组件的样式会受外界影响，可能被覆盖掉。
4.3.2 ViewEncapsulation.Emulated
import { Component, ViewEncapsulation } from '@angular/core';
@Component({
selector: 'my-app',
...,
encapsulation: ViewEncapsulation.Emulated // None | Emulated | ShadowDom
})
export class AppComponent {
name: string = 'Semlinker';
}ViewEncapsulation.Emulated 设置的结果是没有 Shadow DOM，但是通过 Angular 提供的样式包装机制来封装组件，使得组件的样式不受外部影响。虽然样式仍然是应用到整个 document，但 Angular 为 .greet 类创建了一个 [_ngcontent-cmy-0] 选择器。可以看出，我们为组件定义的样式，被 Angular 修改了。其中的 _nghost-cmy- 和 _ngcontent-cmy- 用来实现局部的样式。
4.3.3 ViewEncapsulation.ShadowDom
import { Component, ViewEncapsulation } from '@angular/core';
@Component({
selector: 'my-app',
...,
encapsulation: ViewEncapsulation.ShadowDom // None | Emulated | ShadowDom
})
export class AppComponent {
name: string = 'Semlinker';
}ViewEncapsulation.ShadowDom 设置的结果是使用原生的 Shadow DOM 特性。Angular 会把组件按照浏览器支持的 Shadow DOM 形式渲染。
更多编程相关知识，请访问：编程视频！！
