angular2 学习笔记 ( Component 组件)

更新: 2020-04-05

@Input 和 cdk coercion

abc.component.ts 有一个·@Input value

当 <abc> 组件实例不会有这个 key, Object.keys 拿不到

当 <abc value > 没有写 = 和 <abc value="" > 效果一样, 里面获取到 empty string 有 key 了

当 <abc [value]> 没有写 = 和 <app [value]=""> 和 <app-abc> 效果一样, 里面没有 key

当 <abc [value]="undefined"> 里面有 key, value 是 undefined

当 <abc [value]="null"> 里面有 key 是 null

当 <abc value="what ever value"> 里面获取到的都是 string value

coercion 的任务就是把 string value 转成 boolean or number 等, 这样在外部写起来就可以比较简单. (当然也有人不鼓励这种写法, 任务 should be 写成 [value]=" 'dada' ")

比如, undefined null false 最终等于 false, 其余情况返回 true

export function coerceBooleanProperty(value: any): boolean {
  return value != null && `${value}` !== 'false';
}

number 的话就必须是可以转 number 的 value 不然就是 fallback to 0

export function coerceNumberProperty(value: any, fallbackValue = 0) {
  return _isNumberValue(value) ? Number(value) : fallbackValue;
}

更新: 2020-03-22

?. safe natigation operation

javascript 有 obj?.prop 和 ??

目前 ng 只有 ?.

js 的返回值是 undefined, ng 是 null

这里有点不同啦.... ng 的世界大部分都是 null. 可能是这个原因才和 js 不一样吧

更新 : 2020-02-13

当 ng-content 遇上 ng-if

https://github.com/angular/angular/issues/22972

下面这个是正确用法

<ng-template #content><ng-content></ng-content></ng-template>
<div *ngIf="flag">
          <ng-container *ngTemplateOutlet="content"></ng-container>
</div>
<div *ngIf="!flag">
          <ng-container *ngTemplateOutlet="content"></ng-container>
</div>

如果我们不把 ng-content 放入到 template 之后, 那么结果是它永远会放到第一个 element 里面，不过 ngIf 是 true or false

原理就是 ng-content 是不理会其它人的，你放哪里它就只能在哪里，而且只能渲染一次.

所以上面这个方案就很巧妙的实现了.

更新: 2019-11-28

ngProjectAs 和 contentchild

@ContentChild('name') name 是一个模板变量而不是一个 css selector, 通常如果需要 content 的话，我们一般会特地创建指令, 这样比较好管理

<ng-content select="cssSelector" > 这个却是一个 css selector, 有时候会 confuse.

在说说 ngProjectAs

有时候外部的内容被 ng-container 抱起来了

<ng-container>
  <div myDir >dada</div>
</ng-container>

<ng-content select="[myDir]" >

@ContentChild(MyDirDirective)

由于被 ng-container wrap 了，所以上面 2 个 select 都出不来.

解决方法是

<ng-container ngProjectAs="[myDir]" >
  <div myDir >dada</div>
</ng-container>

ivy 目前有 bug, 希望赶快 fix.

https://github.com/angular/angular/issues/34120

更新 : 2019-01-03

原来 @ContentChild 是可以找到 sibling 指令或组件的

不小心看到 routerLinkActive 的源码，发现它是使用 @Contentchild 来获取 routerlink 的

本来觉得有点怪，contentchild 不是只能获取到 transclude 的指令吗, 可是 <a routerlink routerlinkactive > 也可以 sibling 用啊.

做了测试才知道原来一直都是可以的.

多个 ng-content 时要留意

refer : https://www.youtube.com/watch?v=PTwKhxLZ3jI

<ng-content></ng-content>
after
<ng-content></ng-content>

当模板中有超过一个 ng-content 时, 只有最后一个会显示出来. 就是 after 之后的那个.

<ng-content *ngIf="true" ></ng-content>
after
<ng-content *ngIf="false" ></ng-content>

这样的话, 你可能以为第一个会展现，但其实是不会，因为 ng-content 是最后一个，而最后一个 ngif 确实 false 所以就什么也没展现了.

试试用 ng-template + ng-container 来 append

<ng-template #template>
   <ng-content></ng-content>
</ng-template>

<ng-container #target ></ng-container>
<div (click)="append()" >append</div>

结果第一个是有 content 的，接下来就没有了.  ngFor 也是如此

如果我们可以接受只有其中一个 ngIf 获取到 content 那么，写法可以是这样的.

这个其实也是上面 template + container 的概念做的.

<ng-template #content>
    <ng-content></ng-content>
  </ng-template>
<ng-container *ngIf="true" >
    <ng-template [ngTemplateOutlet]="content" ></ng-template>
</ng-container>
<ng-container *ngIf="true" >
    <ng-template [ngTemplateOutlet]="content" ></ng-template>
</ng-container>

更新 : 2018-12-22

viewchild viewchildren contentchild 使用细节

补上一些之前没有写清楚的细节

XXChild vs XXChildren

child 返回第一个被 select 中的值,

children 返回一个 queryList 对象

child 的好处是简单, 适合用于只有一个值而且这个是固定存在的情况下

children 除了可以获取到多个值以为，另一个特色是它可以 watch, 当数量变化时可以监听到.

contentXX vs viewXX

区别是查找的区域不同

比如你在 test.component 里写了这 2 个 query

view 的查找区域是 test.component.html

ng-content, ng-template内, 内组件的模板都不在其查找范围内哦

<ng-content></ng-content>
<ng-template>
    <abc></abc>
</ng-template>
<abc></abc>

上面只有最后一行是在范围内的, 而 abc.html 里头的 component 也不在范围内了. (所以没有层中层找的概念)

content 的查找区域来至于 trancslude

同样的 ng-template, ng-content. 组件内的模板也都不算在范围哦

<test>
   <ng-template>
       <abc></abc>
   </ng-template>
   <ng-content></ng-content>
    <abc></abc>
    <div>
        <abc></abc>
    </div>
</test>    

这里有个值得注意的点

@ContentChild(Abc, { descendants: true })

descendants 子孙, 默认是 false. 意思是只搜索第一层的 element, 最后那个被 div 包起来的 abc 组件是搜索不到的

如果设置是true, 那么 div 内的 abc 才可以获取到. 它的区别只是这个而已哦.

另外还要讲讲 read

XXChild(firstParam).

firstParam 可以是任何依赖注入. 比如一个 class, 一个 token. 虽然说是模板查找但是其实是依赖注入查找来的.

比如 :

ViewChild(Xyz)

假设 abc.compomnent 的 decorator 声明了 providers : [{ provide Xyz, useClass: WhatEverClass }]

那么 ViewChild 是会找到这个 WhatEverClass 的

除了 class token, 还可以是模板变量

这里就会需要用到 read 了

比如 test.html

<abc #abc ></abc>
<div #div ></div>
<div someDir #dir1 ></div>
<div someDir #dir2="someDir" ></div>

viewchild('abc') 获取到 abc component

viewchild('div') 获取到 elementRef 注意这里是 ref 而不是直接拿到 element

viewchild('dir1') 获取到 elementRef 模板变量遇到 component 就会拿 component, 遇到指令不会有设么特别反应，所以依然获取的是 elementRef

viewchild('dir2') 获取到 someDir 因为我们写了一个 =exportAsDir

所以最关键的地方是第 1 个, 当模板变量没有指定获取指令时，如果 element 是 component, ng 会认为我们要的是 component 而不是原生 html element

这个合理, 因为其实 component 当然也是 html element 丫，在 custom element 的情况下也是. 当然对于后端渲染就不一样啦

所以呢，如果我们想要的是原生 element 而不是 component 我们就必须做一些额外的处理.

viewchild('abc', { read : ElementRef })

这样就可以了, 随带一提, 这个默认选 component 的设计, 在我们只使用模板变量时尤其糟糕, 因为我们无法告诉 ng 选择原生 html element 唯一的方法就是通过 viewchild 或者使用另个一指令来曝露. 比如写一个 native 指令来干这个事儿...

<abc native #native="native" ></abc>
<div (click)="log(native.element)" >click</div>

最后如果是第 4 个场景

<div someDir #dir2="someDir" ></div>

viewchild('dir2') 会获取到 someDir 但是如果我们硬加上 read, 最后 read 会优胜.

viewchild('dir2', { read : ElementRef }) 最后依然是 elementRef

更新 : 2018-12-19

模板语法 'as' 的原理

<div *ngIf="condition as value; else elseBlock">{{value}}</div>

以前我以为 'as' 应该被视为 NgIfAs 指令, 但是在源码里却没找到

问了大神 Trotyl 后才知道

as 是 let 的严格语法糖，`foo as bar` 就是 `let bar = foo`，不过两者省略内容时的自动补全不同，`as bar` 会被补全为 `<directiveName> as bar` 而 `let bar` 会被补全为 `let bar = $implicit`。。一个很常见的用户误解是认为 as 和前面的表达式有关系，*ngIf="condition as value" 会被直接断句为 *ngIf="condition; as value" 而后补全为 *ngIf="condition; ngIf as value"，换成 let 语法就是 *ngIf="condition; let value = ngIf"。。

依据上面这个解析, 如果有 2 给 async 回如何呢 ？

<div *ngIf="(can$ | async) as can && (super$ | async) as super else loading" >
   {{ super }}
</div>

自然是直接报错咯~~

只能有一个 as, 下面这样才对. ng 会用最后一个 async 作为 context.ngIf 的值, 如果我们把顺序调过来, super 的也会跟着变化

<div *ngIf="(can$ | async) && (super$ | async) as super else loading" >
   {{ super }}
</div>

<ng-template [ngIf]="(can$ | async) && (super$ | async)" [ngIfElse]="loading" let-super="ngIf" >
   {{ super }}
</ng-template>

如果遇到这种情况，可以使用 combineLatest 做一个合并的流, 或者 nested ngIf 来实现. 虽然看上去有点蠢...哈哈

更新 : 2018-04-02

component 也可以当指令用

<div app-super >kknd</div>
<div>
  <app-super>
    kknd
  </app-super>
</div>

上面几乎是等价的, 虽然 component 通常都是 element, 但其实也是可以写成 attribute 的, 不过一个 element 只能绑定 1 个.

@Component({
  selector: '[app-super]',
  templateUrl: './super.component.html',
  styleUrls: ['./super.component.scss'],
  changeDetection: ChangeDetectionStrategy.OnPush
})

更新 : 2018-04-01

结构指令 + 微语法 + template

refer : https://angular.cn/guide/structural-directives#microsyntax (微语法规范)

<mat-row *matRowDef="let row; columns: displayedColumns"></mat-row>

其实之前也说过了，只是说的不详细, 多举些例子熟悉一下.

像上面这种写法，非常适合做动态插入模板.

原理是用一个结构指令把 template 存起来，稍后才输出

<app-super *dada="let contextName = name; let $implicitValue; columns: 100">
  {{ $implicitValue }} <br> {{ contextName }}
</app-super>

<ng-template dada [dadaColumns]="100" let-$implicitValue let-contextName="name">
  <app-super>{{ $implicitValue }} <br> {{ contextName }}</app-super>
</ng-template>

上面 2 个写法是完全一样的意思, 第一个在 ng 编辑之后会变成第 2 个. （第一个只是美一点罢了）

我们通常会使用第一种写法.

需要注意几个事儿.

* 表示是 ngtemplate 把 super 包起来,

dada 是结构指令

let $implicitValue 可以写成任何的变量, let whatever, 最终它的值是 ngTemplateContext.$implicit

columns 编辑后会变成 [dadaColumns] 就是把 *dada <--这个指令名加上去 prefix. dadaColumns 可以是 input or 另一个指令都可以,

这里有一个点要留意, 就是第一个字大小写, 按理说 dadaColumns input 应该时对应 Columns 第一个字大写，但是 ng 会无视掉, 大小写都可以. 但是呢, ide 会报错.

虽然报错，但是运行时正确的.

let contextName = name 这个对应 变量 = ngTemplateContext.name

在要使用它的地方调用就可以了. 从 dada 里面拿出 template 输入 context

<ng-container *ngTemplateOutlet="dada.template; context: { name : 'xinyao', $implicit : 'value' }"></ng-container>

p,s 微语法的顺序要注意,

*dada="columns: 100;let contextName = name; let $implicitValue;" <-- 这样是不可以的，开头一定要 let ...

*dada="let contextName = name; let $implicitValue; columns: 100" <-- OK

*dada="let $implicitValue; let contextName = name; columns: 100" <-- OK

dada 指令

import { Directive, TemplateRef, Input } from '@angular/core';

export class Person {
  name: string
  $implicit = 'value'
}

@Directive({
  selector: '[dada]',
  exportAs : 'dada'
})
export class DadaDirective {

  constructor(
    // 通过注入获取到当前模板, 因为指令会放在模板上面,所以可以注入到
    //
    public template: TemplateRef<Person>
  ) { }

  @Input('dadaColumns') // ng 的规范是
  columns: number 

}

更新 : 2018-03-11

[attr.href]="null"  null 可以把 attribute href 给移除.

更新 : 2018-03-09

更新 : 2020-05-18

router-outlet 真的是奇葩, 它渲染的组件 afterViewInit 会触发的非常早

<app-abc></app-abc>
<app-kkk></app-kkk>
<router-outlet></router-outlet>

一般上 after view 都是在最后最后跑的，kkk 的 after view 一定是等到, abc 里面所有 view 都至少解析了 onInit 才有可能跑

但是呢， router-outlet 内的组件，只要 abc kkk init 完, 就会跑了，不会等到 abc 里面的 html 解析. 不是很清楚为什么是这样. 有空才研究呗

原因是 router-outlet 在 init 的时候就会去判断 active 然后就马上 append 组件了. 如果我们自己写动态组件, 在 app init 直接 insert 出去到上面这个 html 里

效果也是一样的那个组件会先触发 after view 比 abc 的内层组件 oninit 还要早.

补充 :

constructor 阶段
app.html
view scan 顺序是 上到下，外到里 (dir 的顺序不是预计你放哪个在前面，而是 declarations 的顺序)
<1 3 2 >
   <4></4>
</1>
<5></5>
依照顺序每个 component and directive constructor 运行.
这一个 view 搞定后, 进入 1 comp 的 view 重复上面的 view scan，一直重复往里面进, 直到没有 component or directive 了就退回上一个 view
比如退回到这 view, 再进入 4 的 view... 然后 5 的 view..
搞定后这个阶段就结束了。全世界的 comp and dir 都 constructor 了.

onInit, onContentInit, ContentChecked, render 阶段
依照上面的顺序，逐个 oninit, 这时 @input 就有了. 但要小心，因为 1 comp onInit 比 2 dir 早
如果 1 comp 依赖 2 dir 的值就要小心哦,
你可以依赖 2 dir constructor 后的值，但不可以依赖 2 dir onInit 的值 (因为它都还没有 onInit)
这一个 view 搞定 onInit 后, 先不要进入 1 comp 的 view。
而是继续在这个 view 跑 onContentInit 和 ContentChecked
顺序是这样的 里到外，上到下 （dir 后于 comp 哦）
<2 4 3>
   {{ render1 }}
   <1>{{ render2 }}</1>
</2>
<5></5>
onContentInit和ContentChecked 是一起跑的，而不是跑完全部人的 onContentInit 才跑 ContentChecked. 是紧接着一起，不是分开哦.
这一个 view 完成后, 就跑这一页的 render,这时 render1,2 的 getter 就会触发了.
到这里 app view 渲染算是完成了，现在要处理它的孩子们.
我们从 2 comp 的 view 开始运行 onInit 阶段. 然后递归进去..
这里有个关键就是，什么时候一个 comp 的 viewInit 会被触发.
答案是 这个 comp 的 parent view 处理完所有 comp init 阶段后.
比如 2 comp 的 viewinit 什么时候触发.
2 comp view 即使 render 了它也不会触发.
而是等到 2 comp 的 parent 也就是 app view 处理完所有 comp (2,4,3,1,5 comps) 之后, 才会逐个调用 2,4,3,1,5 的 viewInit and viewchecked.
这 2 也是紧接着一起触发的。

ng 的顺序

start from html
scan 上到下,外到里 把所有组件和指令都实例化 constructor
note : constructor 阶段拿不到 input 值
顺序是这样
app.component.html
<1>
<2>{{ renderValue1 }}</2>
</1>
{{ renderValue2 }}
<3></3>
完了之后按顺序进入组件的模板, 然后重复上面的实例化一直 loop 到最里面里面完.
全部实例化完后，回到最初的模板.
开始一个个组件 OnInit, 顺序一模一样
init 的时候就可以拿到 input 值了，如果有 viewchild 也都拿到了
因为所有组件都实例化了嘛, 不过特别注意，虽然你拿到 viewchild 组件，但是这些组件都还没有 OnInit 哦.
这也是为什么会有 afterViewInit 的意思了。懂了吧.
这一模板 OnInit 完了之后
开始一个个组件 run AfterContentInit and AfterContentCheck, 上到下, 里到外
为什么是这个时候 run 呢？
因为我们上一个步骤才把这一页所有的组件 OnInit 啊.
比如 <2></2> 就是一个 transclude 的, 我们刚把它 Oninit 好，现在就要通知 <1></1>
调用它的 afterContentInit and checked 了
特别注意, 虽然这里调用了checked, 但其实目前这个模板是还没有 reader 的
比如 renderValue 是一个 getter, 这个时候, 是还没有被调用过的.
等到这一模板所有的 afterContentInit and checked 后, 这个模板就开始 render 了
renderValue getter 被触发.
这一模板算是搞定一大半了, 现在我们就开始进入 <1> 的模板
在 <1> 的模板里，要做的事情依旧是一个个组件 OnInit -> afterContent -> render
和刚才一样. 假设这个 <1> 模板 reder 完了之后发现, 发现已经没有子层组件可以继续深入了。
那么它就会调用 <1> 的 AfterViewInit.
然后退出这个模板回到上一个.
所以这个进入返回的循环就成立了。
当我们深入完 <3></3> 并且返回了之后，最初的模板就没有组件可以在深入了。这时我们就调用
AfterViewInit 假设我们最初这个模板就是 AppComponnt, 那么 AppCompoennt.AfterViewInit 后
整个循环也就结束了.

实例化所有的 component and 指令 (所有包括子孙的 view 里面的)

init 这个模板的所有 component (外面到里面)

template 如果在这个模板上会被渲染的话, 会先去 render template 的内容, 比如 *ngIf='true', templateoutlet

contentInit 这个模板的所有 component （里面到外面）

render 这个模板 (binding data)

递归的进入子孙层, 循环上面的顺序

循环完了以后, viewInit 这个模板的 component (里面到外面), 概念 : component 的 viewInit 是依据使用它的组建的模板决定执行时间的，不是说这个 component render 了以后就马上执行 viewInit. 注意哦

更新 : 2018-02-08

ng 的顺序

一个组件的顺序很好理解 construtor -> init -> content -> view

但层中层有时候就容易昏头了

这里记入一下,

1. 所有的 construtor 一定是先执行的 (一直到子孙层, 全部执行, 除了在 ng-template 的不会马上运行)

2. 把模板中所有的 component onInit 一遍, 上到下，外到里

3. 然后在模板中寻找拥有 transclude 的 component, 并运行 afterContent 里到外

4.只要模板中存有其它 component, 就必须等到这些 component 都 after view 了, 自己才能 after view.

4. 模板中的 component 要 afterviewinit 必须等到整个模板的子孙层都遍历 2-4 一遍, 子孙全部好了,
在依据上到下，里到外去把模板中每一个 component 运行 afterviewinit 另外说一点,  ng-template + transclude content + ngtemplateoutlet 其实就是把模板内的组件移入子层，它会在 aftercontent 之后才运行 construtor, 然后其它的顺序就连上普通的了.

我之前一直以为 template 会在 after view 之后才跑，其实不会, 它和一般 component 是一样的执行只是 construtor 有点奇葩而已.

看例子 : youtube link :  https://www.youtube.com/watch?v=rQEfUG3GN40&feature=youtu.be (给我自己看的)

更新 : 2018-02-01

viewchild 的循环引用

有时候我们会遇到循环引用比如 parent 使用了 viewchild 同时 child 又 inject 了 parent component

这时我们可以使用

@ViewChildren(forwardRef(() => SZoomComponent))

 或者是  construtor @Inject(forwardRef(() => SZoomComponent))

2者运用场景不同，这里不细说了。 

 

 

 

更新 : 2017-10-18

当 local variable 遇到 ngIf

<div (click)="input.focus()" >click</div>
<input *ngIf="true" #input type="text">

上面 focus 会报错, 因为 ngIf 会打乱顺序.

解决方法就是使用 viewchild

  @ViewChild('input', { read : ElementRef })
  input : ElementRef

<div (click)="input.nativeElement.focus()" >click</div>
<input *ngIf="true" #input type="text">

注意这时 input 变成了 ElementRef 类型了

select option 用 [value] 和 [ngValue] 的区别

基本上用 [ngValue] 就对了, [value] 只能是 String.

如果用 mat-option 那是没有 [ngValue] 的, 但是它的 [value] 其实就是 [ngValue] 的功能

更新 : 2017-10-14

ViewChildren + 派生类

<form [formGroup]="form"
    [fGroup]="edm"
    (ngSubmit)="submit()">
    <s-mat-input controlName="name"></s-mat-input>
    <s-mat-upload controlName="images"></s-mat-upload>
    <button type="submit">submit</button>
</form>

比如我们想把所有的 control select 出来

app.component.ts

  @ViewChildren(AbstractAccessorComponent, { read: AbstractAccessorComponent })
  accessors: QueryList<AbstractAccessorComponent>

mat-input.ts 通过依赖注入就可以了

@Component({
  selector: 's-mat-input',
  templateUrl: './input.component.html',
  styleUrls: ['./input.component.scss'],
  providers: [{
    provide: AbstractAccessorComponent,
    useExisting: forwardRef(() => InputComponent)
  }]
})
export class InputComponent extends AbstractAccessorComponent implements OnInit {

  required = false;

  ngOnInit() {
    super.ngOnInit();
    this.required = this.fControl.validators.find(v => v.name == 'required') != null;
    this.inputType = this.fControl.ui.accessorType.substring('input'.length).toLowerCase();
  }
}

更新 : 2017-09-05

<app-abc [comp]="ttc" ></app-abc>
<app-efg #ttc ></app-efg>

组件可以这样沟通, 但执行顺序我们要搞清楚哦.

依据 element 的结构, app-abc 会先被 onInit, 这时我们可以获取到 efgComponent 实例, 但是这个 efg 实例只是个对象有一些原始值, 但还没有被 onInit 过. 所以如果我们想依据它来做渲染, 那么要 settimeout 哦。

 

更新 2017-08-30

监听 transclude components 变化

test-dada.component.html

<test-dada>
    <dada-child *ngFor="let item of items"></dada-child>
</test-dada>

dada-child.component.ts

export class DadaComponent implements OnInit, AfterContentInit {

  @ContentChildren(DadaChildComponent, { read : DadaChildComponent })
  dadaChildComponents: QueryList<DadaChildComponent>

  ngAfterContentInit() {
     this.dadaChildComponents.changes.subscribe((c) => {
       console.log('changed', c);
　　    console.log(c === this.dadaChildComponents); // 是一样的
     });
  }
}

test-dada.component.ts

changItem() {
  this.items.push({ Id : 4, value : 'd' }); // ok
  this.items = []; // ok
  this.items[0].Id = 5; // ok or fail (依据有没有使用 trackby)
  this.items[0].value = 'dada'; // fail
}

不管有没有使用 onPush, 不管有没有 immutable, ng 都可以监听到 array 的增加和减少. 需要注意的是 ng 是i通过 trackby 来做对比的, 然后判断 array 的存在与否.

要在 component 内绑定全局事件的话，可以使用 @HostListener, 它会随着 component destroy 而 unbind, 很方便的哦.

export class StoogesAppComponent implements OnInit {
  @HostListener('document:click', ['$event'])
  private documentClick(event: Event) {
    this.globalClicked$.emit(null);
  }

　　@HostListener('window:resize', ['$event'])

　　　　onResize(event) {

　　　　console.log(event.target.innerWidth);

　　}

 }

更新 2017-08-29

ng-template 使用

之前讲过, 不过例子不整齐, 这里重写一个

<app-dada>
  <ng-template #resultTemplate let-insideValue="insideValue">
    {{ insideValue }}
  </ng-template>
  <ng-template #optionTemplate let-i="index" let-item="$implicit">
    {{ i }} : {{ item }}
  </ng-template>
</app-dada>

我们想把 2 个模板传进 dada 组件里, 其中一个还是用于 ngFor 哦 (注意, $implicit 用来获取 ngFor 的 item)

此外我们还通过 let-insideValue 来和 dada 组件沟通, 这个 insideValue 是由 dada 组件负责填入的.

export class DadaComponent implements OnInit {

  constructor() { }

    @ContentChild('resultTemplate', { read: TemplateRef }) resultTemplateRef: TemplateRef<{ insideValue: string }>

  @ContentChild('optionTemplate', { read: TemplateRef }) optionTemplateRef: TemplateRef<NgForOfContext<string>>

  items = ['a', 'b', 'c'];

  ngOnInit() {

  }

}

达达组件定义好 2 个 templateRef, 我们也可以使用 @Input 传入 templateRef, 但这里我们用的是 translude 的手法.

dada.component.html

<ng-container *ngTemplateOutlet="resultTemplateRef; context: { insideValue : 'insideValueDone' }"></ng-container>
<ng-template ngFor [ngForOf]="items" [ngForTemplate]="optionTemplateRef"></ng-template>

这样就可以了.

更新

<img [sImage]="[image, scene]" >

如果 input/directive 的表达式是 array [], 那么 ng 会判断里面的每一个值, 如果有一个不同就会触发 onChange 如果没有则不会. 

 

更新 2017-06-30

组件是可以继承来用的. 很多时候 template, css 是一直变化的，但是 controller 逻辑却经常一样，所以就可以使用继承来解决了.

@Component({
  selector: 'app-test',
  templateUrl: './test.component.html',
  styles: [],
  changeDetection: ChangeDetectionStrategy.OnPush,
  // 如果父组件是 accessor 记得这里要写 provider 哦
  providers: [{
      provide: NG_VALUE_ACCESSOR,
      useExisting: forwardRef(() => TestComponent),
      multi: true
  }],
})
export class TestComponent extends PaginationComponent implements OnInit {

  constructor(
    cdr: ChangeDetectorRef,
    validators: ValidatorsService
  ) {
    super(cdr, validators); // 父组件需要什么就注入什么
  }

  ngOnInit() {
    super.ngOnInit(); // 记得调用父组件哦
    // do something else ...
  }
}

使用 extends 就可以了, selector, css, template 都必须 override

ngOnInit, OnDestroy 这些，如果子组件没有 override, 父组件依然会自动跑，如果你 override 了请自己决定要不要调用.

更新 2017-03-15

image src biding 404 注意事项

<img [src]="data" >

data = "" 就不会去加载图片( undefined, null 也是去加载哦 ), 其余情况下，模板一旦渲染就会马上去加载.

好的处理就是写个 ngIf 等待 async data 回来才渲染图片.

更新 2017-03-03:

ng 上写 keyCode 事件

<input
    (keydown.arrowUp)="$event.preventDefault()"
    (keydown.shift.tab)="$event.preventDefault()"
    type="text"  />

看的出就是把 keyCode.key 写成驼峰式就可以监听到了. 配合 shift 也很容易写哦.

QueryList & transclude Content

@ContentChildren(OptionComponent) options: QueryList<OptionComponent>

在处理 ContentChildren 时要注意几件事. 如果我们想监听它的 length 改变, 可以使用 change.subscribe(...)

如果你想监听 content 内 component 的事件，你要记得 rewatch，像我上面那样，因为 content 的数量是动态的，compoennt 会被创建和销毁, 一旦销毁了, 你的监听也被销毁，而新创建的你得再监听一次.

如果你想在数量变化之后对 content 进行操作，你得写一个 timeout, 让它触发下一次的 digest

最近自己在写 multiple select 有些发现

ng 的 select option 的 2 个小逻辑 :

<select [(ngModel)]="hero.skillId" name ="skillId">
    <option *ngFor ="let skill of skills" [ngValue]="skill.id">{{ skill.name}}</ option>
</select>

1.如果你修改 skills 的话, this.skills[0].value = "bla bla" 或 this.skills = new array ..

ng 通过 doCheck 检测到你的修改, 然后做出更新. 如果当前的 model value 无法在新的 options 中匹配到的话, ng 不会做任何处理.

2.即使你写 trackBy, 当你把 skill.value 换掉后, ng 无法通过 trackBy 找到对的 value 来更新. e.g your select is { Id :1,value :"v" }, then you change skills to [{ Id:1,value:"ttc" }] after detectchange    your model still "v".

3.由于是直接 muta skills, ng 只能通过 doCheck 来检查, 在 ChangeDetectionStrategy.OnPush 的情况下, ng 会直接坏掉哦. 解决方法就是手动触发 changeDetect. 参考 OnPush : http://www.cnblogs.com/keatkeat/p/5963295.html

更新 : 2017-02-11

angular drag & drop 如果不要使用 plugin 的话, 可以用最基本的写法

可以参考原生 html 的例子 : http://www.w3schools.com/html/html5_draganddrop.asp

<form [formGroup]="form" submitableForm>
  <s-upload #imagesUpload [config]="uploadConfig" formControlName="images"></s-upload>
    <div *ngFor="let fileData of imagesUpload.fileDatas"
      draggable="true"
      (dragstart)="imagesUpload.dragingFileData = fileData"
      (dragend)="imagesUpload.dragingFileData = null"
      (dragenter)="imagesUpload.dragingFileData && imagesUpload.moveFileData(fileData,imagesUpload.dragingFileData)"
      [sDragover]="imagesUpload.dragingFileData"
      class="uploadImage">
      <img [src]="fileData.file" width="100px">
      <i [show]="fileData.loading" class="fa fa-spin fa-spinner loading"></i>
      <i (click)="imagesUpload.removeFileData(fileData)" [show]="!fileData.loading" class="fa fa-times close"></i>
  </div>
</form>

dragingFileData 用于缓存变量

(dragend) 清楚缓存, 缓存还有一个重要用途就是如果你有 2 个 upload file 的时候不允许它们 cross drag

之所以不直接使用 (dragover) 是因为它会一次触发 digest (性能优化), sDragover 是一个指令里面手动添加了 event, 这样就不会一直 digest 了.

更新 : 2017-01-26

component selector 不需要担心和未来游览器撞名字, ng 最终会胜利.

directive 和 component input 不需要担心冲突, 2 个可以一起工作, 都拿得到值.

 

2016-08-28

refer :

https://angular.cn/docs/ts/latest/guide/template-syntax.html

https://angular.cn/docs/ts/latest/cookbook/component-communication.html

https://angular.cn/docs/ts/latest/guide/displaying-data.html

https://angular.cn/docs/ts/latest/guide/user-input.html

https://angular.cn/docs/ts/latest/guide/lifecycle-hooks.html

ng 的组件和游览器原生的组件是同一个概念，在方方面面都很相似.

和 ng1 一样，组件少不了数据绑定

1. model to view 绑定

template: `
    <my-product [model-to-view-value]="'Derrick' + 'Yam'" ></my-product>
`

@Input("model-to-view-value") //如果属性名字不一样的话可以调整
modelToViewValue: string;

有几个点容易让人混淆

1. 左边不使用 [括弧] : <my-product value="abc" > 这样的写法右边的值 "abc" 只是一个很普通的 string, 它并不是引用我们 component instance 的属性哦. 也因为如此, 你之后就不可能改变它的值了. 算是 one time binding and only for string. (html 就是这样).

2.你可能会问如果这样呢 : <my-product value="{{ abc }}" > 这样的话右边的 "abc" 会引用 component instance, 而且会一直保持同步, 也就是说不是 one time binding 了. 但值依然只能是 string. abc must be string.

3. 左边是 [括弧] : <my-product [value]="abc"> 这样的话 abc 就可以传入任何类型了, 也会一直保持同步. 这也是我们最常用的表达模式.

2. 事件绑定 (监听嘛)

和 html 一样，我们内部只返回一个值, 外部通过关键字 $event 来获取

selector: "my-app",
template: `
    <my-product (myClick)="doSomething($event)" ></my-product>
`
doSomething(data: string) { console.log(data) }

selector: "my-product",
template: `
    <div>this is product component</div>
    <div (click)="publish($event)" >publish</div>
`
@Output()
myClick: EventEmitter<string> = new EventEmitter();
publish($event) {
　　 //$event = html original click event
    this.myClick.emit("value");
}

很可惜 ng 的事件不支持冒泡 很可惜 ng 的自定义事件不支持冒泡, 这里和 dom event 不同，不好记 /.\

3.双向绑定

selector: "my-app",
template: `
    <p> value outside :  {{ someValue }}</p>
    <div (click)="updateValue()" >update value from outside</div>
    <my-product [(someValue)]="someValue" ></my-product>
`
someValue: string = "value start";
updateValue() {
    this.someValue = "value updated from outside";
}

selector: "my-product",
template: `
    <div> value inside : {{ someValue }}</div>
    <div (click)="updateValue()" >update value from inside</div>
`
@Input()
someValue: string;
@Output()
someValueChange: EventEmitter<string> = new EventEmitter();
updateValue() {
    this.someValueChange.emit("value updated from inside");
}

其实ng是通过数据绑定加上事件绑定来完成这事儿的, [(value)] 只是语法糖

把它拆开是这样的

<my-product [someValue]="someValue" (someValueChange)="someValue = $event" ></my-product>

如果要绑定原生 html 比如 input, select 等就是用 ng 帮我们做好的 [(ngModel)] 就可以了, 之后我会和表单一起讲.

当我们绑定到原生游览器组件时有些概念要清楚.

dom Attribute 和 dom Property 不是同一个东西

<img src="123.jpg" /> 写在 element 上的是 Attribute, 它的值只用来初始化 property 的值

imgDomObject.src = "456.jpg" 这个才是 property.

ng 的绑定是在 property 上的.

Attribute 和 Property 不总是一对一匹配的, 有些 Attribute 是没有 property 的，这时我们要这样写

<some-elem [attr.attributeName]="..." > 要在前面加 attr.

没有 ng1 的 ng-options 了，现在是这样 :

ng-repeat = *ngFor (*表示结构类型的指令)

<select [(ngModel)]="hero.skillId" name ="skillId">
    <option *ngFor ="let skill of skills" [ngValue]="skill.id">{{ skill.name}}</ option>
</select>

模板中如果有引用对象属性，但是对象是 null 时, 会报错哦. 可以使用 ?. 来处理，这个和 c# 6.0 语法一样

<div>{{ someObj?.value }}</div> 

*ngFor 的值使用的是"微语法"解析, 它和我们平时写模板表达式是不同的哦.

*ngIf 用的也是 "微语法".

track by 的值是一个方法 (一定要是一个方法)

track by 的作用 :

ng 很聪明, 如果 heroes 是值类型的话, 它不会随便的 rebuild element, 比如 : heroes = ["a","b"], 然后 heroes = ["b","a"] 这样 ng 是不会 rebuild 的, 它只会更新 element.

但是如果是引用类型, heroes = [{ Id : 1 },{ Id : 2 }] 然后 [{Id : 2},{Id :1}] , ng 就会 rebuild element 了

为了要性能好一些, 我们尽力不要 rebuild, 可以用 trackby, trackby return 的值决定了需不需要 rebuild.

trackby index 和 Id 的区别 :

[{Id : 1}, {Id :2}] change to [{Id: 2}]

trackby index 的话 destroy 的是 Id 2  (因为 ng 是把 slot 1 的 Id update 去了 2, 然后 destroy 掉 2)

trackby Id 的话 destroy 的是 Id 1

依据你的需求来决定怎样 trackby 哦.

template: `
    <div *ngFor="let hero of heroes; let i=index; trackBy:trackByHeroes" >
        <p>{{ hero.Id }}  {{ hero.name }}</p>
    </div>
`
trackByHeroes(index: number, hero: Hero) {
    return hero.Id;
}

所有的 * 结构指令都只是语法糖, 下面这个才是真正的写法

<ng-template ngFor let-number [ngForOf]="[1,2,3]" let-i="index" [ngForTemplate]="templateRef" [ngForTrackBy]="trackByFn" >

</ng-template>

所以这 3 个是一样的:

1.
<abc>
    <div *="let insideValue = insideValue;" >
        {{ outsideValue }} vs {{ insideValue }}
    </div>
</abc>

2.
<abc>
    <div template="let insideValue = insideValue;" >
        {{ outsideValue }} vs {{ insideValue }}
    </div>
</abc>

3.
<abc>
  <ng-template let-insideValue="insideValue" >
    <div>
        {{ outsideValue }} vs {{ insideValue }}
    </div>
  </ng-template>
</abc>

补上一个对应的

@Component({

　　selector: 'abc',
　　template : `
　　　　<ng-template [ngTemplateOutlet]="templateRef" [ngOutletContext]="{ insideValue : insideValue }" ></ng-template>
　　`
})

注意, 第 3 个的 let-inside 有一个 "-"

我推荐大家使用第 3 个, 虽然长一点，不过好理解，也不容易遇到坑

比如 :

<abc>
  <ng-template #firstContent let-insideValue="insideValue" >
    <div>
        {{ outsideValue }} vs {{ insideValue }}
    </div>
  </ng-template>
</abc>

 @ContentChild("firstContent") templateRef; // 是对的

<abc>
    <div #firstContent *="let insideValue = insideValue" >
        {{ outsideValue }} vs {{ insideValue }}
    </div>
</abc>

 @ContentChild("firstContent") templateRef; // 是错的, 因为拿到的是 div 而不是 template 了.

ngForTemplate 允许我们绑定 templateRef, 比如 transclude 的 viewContent 等等.

<div *ngFor="let number of [1,2,9]" >
    <template [ngTemplateOutlet]="templateRef" [ngOutletContext]="{ data : number }" ></template>
</div>

ngTemplateOutlet 和 ngOutletContext ( ng还在试验中 ) 同样允许我们绑定 templateRef 而且可以注入 context 让 templateRef 通过 let-abc="data" 来调用到 number.

refer : http://stackoverflow.com/questions/37676593/how-to-repeat-a-piece-of-html-multiple-times-without-ngfor-and-without-anoher-c

模板引用变量 ( template reference variables )

template: `
    <input type="text" #input >
    {{ someValue }}
    <div (click)="someValue = input.value" >click</div>
`

#input 表示那个组件( 自定义组件也可以哦 ), 可用范围很广, 父亲，兄弟, 孩子都用的到

它还可以配合自定义指令的 exportAs 来使用, 类似 #variable="exporstAs"; 当一个 element 上有很多指令时, 我们就可以选择要使用那个 class

我们可以很容易的把一个外部的模板传进去组件中，并且沟通. (下面还会介绍一个 transclude)

//outer component

<template #abc let-innerValue="data" >
    <div>{{ outerValue }}</div>
    <div>{{ innerValue }}</div>
</template>
<inner [template]="abc" ></inner>

//inner component 

<p>inner</p>
<template [ngTemplateOutlet]="template" [ngOutletContext]="{ data : 'innervValue' }" ></template>

此外还能用它来获取 element 的 style 比如 height, width, scrollTop 等等  <div #div (click)="doSomething(div.scrollTop)">

管道 Pipe

import { Pipe, PipeTransform  } from "@angular/core";
//pure 的意思是 angular1 的 $stateful
@Pipe({ name: "demoCombine", pure : true })
export class DemoCombinePipe implements PipeTransform {
    transform(value: string, param: string): string {
        return value + " " + param;
    }
}
template: `
    <div>
        {{ name | demoCombine : value }}
    </div>
`,
pipes: [DemoCombinePipe]

transclude 和 ng1 类似

template: `
    <demo-transclude-dir>
        <div class="first" >first space</div>
        <div class="second" >second space</div>
    </demo-transclude-dir>
`,

可以选择任何方式来表示不同分区，我这里使用的是 class

template: `
    <div>
    <ng-content select=".first" ></ng-content>
    <ng-content select=".second"></ng-content>
    </div>
`

内部通过 <ng-content> 配合 dom selector 来匹配区块

transclude 通常会用到一个叫 viewProviders 的东西, 作用是隔离依赖注入, 比如我们不希望外部嵌套进来的 content 能依赖注入内部的 providers 就可以定义载 viewProviders.

viewProviders 只有自己和 child 可以注入到, content 则注入不到.

这里懒得写了

说说一些概念就好

https://angular.cn/docs/ts/latest/guide/lifecycle-hooks.html#!#afterview (生命周期钩子)

主要是说

ngAfterContentInit, ngAfterContentChecked

ngAfterViewInit, ngAfterViewChecked 的使用

Content 拦截指的是 transclude 的内容, 在子层做拦截可以获取 transclude 组件对象然后动一点手脚.

afterView 则指的是子层完成后，在父层做拦截, 这里可以调用到子层组件对象做一点手脚, 不过记得要跑一个 timeout 不然不会渲染 (因为这个阶段渲染已经结束了)

下面是之前写的一些代码 :

demo-interception.component.ts

import { Component } from "@angular/core";

import { DemoInterceptionParentComponent } from "./demo-interception-parent.component";
import { DemoInterceptionContentComponent } from "./demo-interception-content.component";

@Component({
    selector: "demo-interception",
    //注意 demo-interception-content 需要定义一个模板引用和一个class
    //还有 demo-interception-content 的 [value] 也可以让 parent 去拦截做 binding, 不一定要在这里做 binding, 因为重要是 create content component 时要有就可以了.
    template: `
        <div>
           <demo-interception-parent [value]="'parent value'" >
                <demo-interception-content #firstContentRef class="firstContent" [value]="'content value1'" ></demo-interception-content>
           </demo-interception-parent>
        </div>
    `,
    directives: [
        DemoInterceptionParentComponent,
        DemoInterceptionContentComponent
    ]
})
export class DemoInterceptionComponent
{   

}

demo-interception-content.component.ts

import { Component, Input } from "@angular/core";

import { FirstContentInterface } from "./demo-interception-parent.component";

@Component({
    selector: "demo-interception-content",
    template: `
        <div>{{ value }}</div>
    `
})
export class DemoInterceptionContentComponent implements FirstContentInterface {

    @Input() value: string;

}

demo-interception-parent.component.ts

import {
    Component,
    OnInit, OnDestroy, OnChanges, DoCheck, AfterContentChecked, AfterContentInit, ContentChild, ViewChild, AfterViewInit, AfterViewChecked,
    Input, SimpleChange
} from "@angular/core";

import { DemoInterceptinChildComponent } from "./demo-interception-child.component"; 

export interface FirstContentInterface
{
    value: string;
}
@Component({
    selector: "demo-interception-parent",
    template: `
        <div>
            <ng-content select=".firstContent"></ng-content>
            <demo-interception-child [value]="'child value'" ></demo-interception-child>
        </div>
    `,
    directives: [
        DemoInterceptinChildComponent
    ]
})
export class DemoInterceptionParentComponent implements OnInit, OnDestroy, OnChanges, DoCheck, AfterContentChecked, AfterContentInit, AfterViewInit, AfterViewChecked {
    @Input() value: string;

    ngOnInit() {
        console.log("init");
    }
    ngOnDestroy() {
        console.log("destroy");
    }
    //note : 好比以前的 dirty check, 动不动就会跑的, 当心性能哦
    ngDoCheck() {
        console.log("doCheck");
    }
    //note : 当input属性发生变化的时候除非, 使用简单的 === 如果是对象的话不会做深沉对比哦
    ngOnChanges(changes: { [propertyName: string]: SimpleChange }) {
        console.log("onChange");
        //console.log(changes);
        for (let propName in changes) {
            let chng = changes[propName];
            let cur = JSON.stringify(chng.currentValue);
            let prev = JSON.stringify(chng.previousValue);
            //console.log(`${propName}: currentValue = ${cur}, previousValue = ${prev}`);
        }
    }

    //教程是使用 class 而非 Interface 的
    //e.g. : @ContentChild(ComponentClass) contentChild: ComponentClass;
    //但是呢，实际开发的时候, 内部组件不可能预测到外部将传进来什么组件
    //也不可能要求传进来的组件必须继承任何特定的类
    //我们顶多能要求他实现我们的接口而已.
    //"firstContentRef" 这个是通过模板引用来实现的，也算规范, 教程有说可以用模板引用
    @ContentChild("firstContentRef") contentChild: FirstContentInterface; 

    ngAfterContentChecked() {
        this.contentChild.value = "new content child value";
        console.log("afterContentChecked")
    }
    ngAfterContentInit() {
        console.log("afterContentInit")
    }

    //viewChild 拦截是在整个 view 做好之后才出发的
    //所以如果我们想在目前这个 parent component 中对其做调整的话
    //我们必须写一个 setTimeout 使它在 digest 一轮做更新
    @ViewChild(DemoInterceptinChildComponent) viewChild: DemoInterceptinChildComponent;
    ngAfterViewInit() {
        console.log('afterViewInit');
    }
    private record = 0;
    ngAfterViewChecked() {
        console.log(this.viewChild.value);
        //当然需要 if else 啦, 不然不是死循环吗..
        if (this.record == 0) {
            this.record = 1;
            setTimeout(() => {
                this.viewChild.value = "888";
            });
        }
        console.log('afterViewChecked');
    }
}

demo-interception-child.component.ts

import { Component, Input } from "@angular/core";

@Component({
    selector: "demo-interception-child",
    template : `<div>{{ value }}</div>`
})
export class DemoInterceptinChildComponent
{

    @Input() value: string;

}

组件通讯的几个方式

@Input()

@Output()

service

@Input setter or ngOnChanges  ( 针对引用的话, 修改内部是不会触发的哦, 一定要连引用都换掉才行, immuatable 概念)

local variable (refer : https://angular.cn/docs/ts/latest/guide/template-syntax.html)

ViewChild, ViewContent

依赖注入 parent component ( 如果parent是抽象或则有循环引用的话要 refer : https://angular.cn/docs/ts/latest/cookbook/dependency-injection.html )

as 是 let 的严格语法糖，`foo as bar` 就是 `let bar = foo`，不过两者省略内容时的自动补全不同，`as bar` 会被补全为 `<directiveName> as bar` 而 `let bar` 会被补全为 `let bar = $implicit`。。一个很常见的用户误解是认为 as 和前面的表达式有关系，*ngIf="condition as value" 会被直接断句为 *ngIf="condition; as value" 而后补全为 *ngIf="condition; ngIf as value"，换成 let 语法就是 *ngIf="condition; let value = ngIf"。。