目前是 4.0.0-rc.2.
刚好有个小项目要开发，就直接拿它来试水啦.
更新 cli 到最新版, 创建项目, 然后 follow https://github.com/angular/angular/blob/master/CHANGELOG.md 升级去 4.0
遇到一个 error https://github.com/angular/angular-cli/issues/5131
更新 typescript 就可以了.
一些新功能和 break change
1. template 替换成 ng-template 了
<template #loading>Loading...</template> <!--弃用了--> <ng-template #loading>Loading...</ng-template> <!--新的用这个-->
2. if else 增强
<ng-template #loading>Loading...</ng-template> <div *ngIf="user$ | async; else loading; let user"> {{ user.name }} </div>
我们可以很容易的写出这种等待 ajax 资料的代码.
let user 获取到的就是 user$.next 的 value 啦, loading 则是对应一个 ng-template.
RC.5 更新 (一如往常, ng 在 RC 阶段依然可以加入新功能和 breaking change. 厉害吧)
ngIf 和 ngFor 微语法新加入了 "as" 这个词法.
之前 *ngIf="user$ | async; else loading;let user"
之后 *ngIf="user$ | async as user; else loading"
取代了 let, 好处就是, 语义比较有连贯,比较熟悉.
ngFor 也可以
<!--之前--> <div *ngFor="let item of ['a','b','c'] as items; let i = index"> {{item}} {{items.length}} {{i}} </div> <!--之后, 使用 as 替代了 let--> <div *ngFor="let item of ['a','b','c'] as items; index as i"> {{item}} {{items.length}} {{i}} </div> <!--之后, 使用逗号","也可以哦 --> <div *ngFor="let item of ['a','b','c'] as items, index as i"> {{item}} {{items.length}} {{i}} </div>
3. Replace references to TrackByFn to TrackByFunction<any>
4. Validators.email
this.form = this.fb.group({ email : ["", Validators.email] }); let emailCtrl = this.form.get("email"); console.log(emailCtrl.valid); //fail emailCtrl.setValue("hengkeat87@gmail"); console.log(emailCtrl.valid); //ok emailCtrl.setValue("hengkeat87@gmail.com"); console.log(emailCtrl.valid); //ok
这个没什么意义, 相信大家早就自己实现了. 应该是做给那些老师方便他们写 demo 教学生的吧...
5. Validators.equalsTo
this.form = this.fb.group({ password : ["",Validators.equalsTo("confirmPassword")], confirmPassword : [""] });
bug : https://github.com/angular/angular/issues/14770
实现源码 : https://github.com/angular/angular/commit/7b7ae5f
这个相信大家也自己实现了,
记得上次自己写的时候也是遇到 bug /.
6. Select option [compareWith]
<form [formGroup]="form"> <select [compareWith]="compareModel" formControlName="data" > <option *ngFor="let item of items; trackBy:trackBy" [ngValue]="item" >{{ item.text }}</option> </select> </form>
type Item = { Id: number, value: string, text: string }; @Component({ selector: 'app-root', templateUrl: './app.component.html' }) export class AppComponent { constructor( private fb: FormBuilder ) { } form: FormGroup items: Item[] trackBy: TrackByFunction<Item> = (index, item) => { return item.Id; } compareModel(a: Item, b: Item) { return a.Id === b.Id; } ngOnInit() { this.form = this.fb.group({ data: [null] }); this.items = [ { Id: 1, value: "a", text: "A" }, { Id: 2, value: "b", text: "B" }, { Id: 3, value: "c", text: "C" } ]; //this.form.get("data").setValue(this.items[0]); // 在没有 compareWith 的情况下，我们必须放回相同 reference 的对象 this.form.get("data").setValue({ Id: 1, value: "a", text: "A" }); //在设置 compareWith 后，我们可以给不同 reference 的对象 } }
关键就看最后两行的注释.
7. router runGuardsAndResolvers
imports: [RouterModule.forRoot([ { path: 'home', component: HomeComponent }, { path : "about", component : AboutComponent, runGuardsAndResolvers : "always", //"always" || "paramsChange" || "paramsOrQueryParamsChange" 选择不同的检测时机 canActivate : [GuardService] }, { path : "", redirectTo : "home", pathMatch : "full" } ])],
通过 runGuardsAndResolvers 我们可以设置更多的守卫检查时机 (2.x版本只有在进入 route 的时候检查, 如果之后只是修改 params or queryParams 守卫是不会再检测的), paramsChange 指的是 matrix.
8. RouteConfigLoadStart | RouteConfigLoadEnd
route 多了2个 event
当一个 module 被加载 ( preload 也可以) 时就会触发. 主要用途是让我们知道 preload module 加载开始和完成了, 2.x 我们没法监听到.
9. Renderer 换成 Renderer2 了.
10.
OpaqueToken 没有了, 改成 InjectionToken<T>
Injector.get 也有点更换, 支持类型了
let service = this.injector.get<T>(token: Type<T>|InjectionToken<T>, notFoundValue?: T): T;
以上的 T 必须是同一个类型哦. 虽然我放不同类型 typescript 也没有报错 /.
什么时候 formControl 才支持类型 . FormControl<T> 不是很好吗, formContril.value 就有类型可以用 !
11.
ngOutletContext 改成 ngTemplateOutletContext
也支持微语法了.
<ng-template #myTemplate let-value="value" > <div>{{ value }}</div> </ng-template> <ng-template [ngTemplateOutlet]="myTemplate" [ngTemplateOutletContext]="{ value : 'keatkeat' }" ></ng-template> <div *ngTemplateOutlet="myTemplate; context : { value : 'keatkeat' }"></div>
12. call resolver when upstream params change
2.x 版本的 router resolver 比较笨
from "/company/1/employer/1" change to "/company/2/employer/1"
children 的 resolve 是不会重跑一次的. 4.0 开始会跑，即使是 parent 的 route 改变了, child 的 resolve 也会重新跑一次. 这才对嘛
13. router CanDeactivate
多了一个 parameter
@Injectable() export class BlockOut implements CanDeactivate<HomeComponent> { canDeactivate( component: HomeComponent, currentRoute: ActivatedRouteSnapshot, currentstate: RouterStateSnapshot, nextState?: RouterStateSnapshot ): Observable<boolean> | Promise<boolean> | boolean { console.log(currentstate.url); // /home console.log(nextState.url); // /about return true; } }
我们依据 next url 来决定要干什么. 哎哟, 不错哦.
14. SimpleChanges 多了一个 firstChange 熟悉, 早就该有了嘛！
ngOnChanges(changes: SimpleChanges) { let c = changes["value"]; if (c.firstChange) { console.log(c.previousValue); //undefined console.log(c.currentValue); //keatkeat console.log(c.isFirstChange()); //true } else { console.log(c.previousValue); //keatkeat console.log(c.currentValue); //keatkeat2 console.log(c.isFirstChange()); //false } }
15. MetaService
和 Title 类似, 就是让我们可以动态添加修改 Meta 等等. 我还没有测试 server side render , 4.0 好像也有一些变化. 希望有时间 ^^
16. NgComponentOutlet
refer : https://github.com/angular/angular/issues/11168
这个功能是不错，不过我认为 ng 在动态 component 上面还有很多不足够的地方。 这个连 binding property, event 都没有，我不打算用, 没测试了.
17 http params 容易写了
this.http.get("http://localhost:61547/api/businesses", { params: { time: "2016-01-01T05:15:12.0000000+08:00" } }).subscribe(v => console.log(v));
直接传入对象就可以了. (不过上面这个 time string convert 出来好像怪怪的... /.)
18. Renderer2.setStyle
之前是 setElementStyle,
<h1>{{ title | titlecase }}</h1>
titlecase 是说让第一个字母大写, "同时让后面的字母变小写", uppercase, lowercase 就不用介绍了吧.
21 ActivatedRoute.paramMap and queryParamMap
其实 param 是可以有多个相同 key 的, 比如 ?data=10&data=11
而获取的资料是 ActivatedRoute.params["data"] = ["10","11"];
ng 为了要更好的区分这个情况而改进了，现在可以使用 ActivatedRoute.paramMap.get("data") or paramMap.getAll("data") 来做single and multiple 区分.