在angular中,我们可以通过Title来设置页面标题。我们从platform-browser
导入Title
, 同时也导入Router
。
import { Title } from '@angular/platform-browser';
import { Router } from '@angular/router';
导入之后,我们在组件的构造函数中注入他们
@Component({
selector: 'app-root',
templateUrl: `
Hello world!
`
})
export class AppComponent {
constructor(private router: Router, private titleService: Title) {}
}
在使用Title
之前,我们先看下Title
是如何定义的
export class Title {
/**
* Get the title of the current HTML document.
* @returns {string}
*/
getTitle(): string { return getDOM().getTitle(); }
/**
* Set the title of the current HTML document.
* @param newTitle
*/
setTitle(newTitle: string) { getDOM().setTitle(newTitle); }
}
Title
类有两个方法,一个用来获取页面标题getTitle
, 一个是用来设置页面标题的setTitle
要更新页面标题,我们可以简单的调用setTitle
方法:
@Component({...})
export class AppComponent implements OnInit {
constructor(private router: Router, private titleService: Title) {}
ngOnInit() {
this.titleService.setTitle('My awesome app');
}
}
这样就可以设置我们的页面标题了,但是很不优雅。我们接着往下看。
在AngularJS中,我们可以使用ui-router为每个路由添加一个自定义对象,自定义的对象在路由器的状态链中继承:
// AngularJS 1.x + ui-router
.config(function ($stateProvider) {
$stateProvider
.state('about', {
url: '/about',
component: 'about',
data: {
title: 'About page'
}
});
});
在Angular2+中,我们也可以为每个路由定义一个data对象,然后再在监听路由变化时做一些额外的逻辑处理就可以实现动态设置页面标题。首先,我们定义一个基本的路由:
const routes: Routes = [{
path: 'calendar',
component: CalendarComponent,
children: [
{ path: '', redirectTo: 'new', pathMatch: 'full' },
{ path: 'all', component: CalendarListComponent },
{ path: 'new', component: CalendarEventComponent },
{ path: ':id', component: CalendarEventComponent }
]
}];
在这里定义一个日历应用,他有一个路由/calendar
, 还有三个子路由, /all
对应日历列表页,new
对应新建日历,:id
对应日历详情。现在,我们定义一个data
对象然后设置一个title
属性来作为每个页面的标题。
const routes: Routes = [{
path: 'calendar',
component: CalendarComponent,
children: [
{ path: '', redirectTo: 'new', pathMatch: 'full' },
{ path: 'all', component: CalendarListComponent, data: { title: 'My Calendar' } },
{ path: 'new', component: CalendarEventComponent, data: { title: 'New Calendar Entry' } },
{ path: ':id', component: CalendarEventComponent, data: { title: 'Calendar Entry' } }
]
}];
好了,路由定义完了,现在我们看下如何监听路由变化
Angular路由配置非常简单,但是路由通过Observables使用起来也非常强大。
我们可以在根组件中全局监听路由的变化:
ngOnInit() {
this.router.events
.subscribe((event) => {
// example: NavigationStart, RoutesRecognized, NavigationEnd
console.log(event);
});
}
我们要做的就是在导航结束时获取到定义的数据然后设置页面标题,可以检查 NavigationStart, RoutesRecognized, NavigationEnd 哪种事件是我们需要的方式,理想情况下NavigationEnd
,我们可以这么做:
this.router.events
.subscribe((event) => {
if (event instanceof NavigationEnd) { // 当导航成功结束时执行
console.log('NavigationEnd:', event);
}
});
这样我们就可以在导航成功结束时做一些逻辑了,因为Angular路由器是reactive
响应式的,所以我们可以使用 RxJS 实现更多的逻辑,我们来导入以下操作符:
import 'rxjs/add/operator/filter';
import 'rxjs/add/operator/map';
import 'rxjs/add/operator/mergeMap';
现在我们已经添加了 filter
,map
和 mergeMap
三个操作符,我们可以过滤出导航结束的事件:
this.router.events
.filter(event => event instanceof NavigationEnd)
.subscribe((event) => {
console.log('NavigationEnd:', event);
});
其次,因为我们已经注入了Router类,我们可以使用 routerState 来获取路由状态树得到最后一个导航成功的路由:
this.router.events
.filter(event => event instanceof NavigationEnd)
.map(() => this.router.routerState.root)
.subscribe((event) => {
console.log('NavigationEnd:', event);
});
然而,一个更好的方式就是使用 ActivatedRoute 来代替 routerState.root
, 我们可以将其ActivatedRoute
注入类中:
import { Router, NavigationEnd, ActivatedRoute } from '@angular/router';
@Component({...})
export class AppComponent implements OnInit {
constructor(
private router: Router,
private activatedRoute: ActivatedRoute,
private titleService: Title
) {}
ngOnInit() {
// our code is in here
}
}
注入之后我们再来优化下:
this.router.events
.filter(event => event instanceof NavigationEnd)
.map(() => this.activatedRoute)
.subscribe((event) => {
console.log('NavigationEnd:', event);
});
我们使用 map
转换了我们观察到的内容,返回一个新的对象 this.activatedRoute
在 stream
流中继续执行。 我们使用 filter(过滤出导航成功结束)
和 map(返回我们的路由状态树)
成功地返回我们想要的事件类型 NavigationEnd
。
接下来是最有意思的部分,我们将创建一个while循环遍历状态树得到最后激活的 route,然后将其作为结果返回到流中:
this.router.events
.filter(event => event instanceof NavigationEnd)
.map(() => this.activatedRoute)
.map(route => {
while (route.firstChild) route = route.firstChild;
return route;
})
.subscribe((event) => {
console.log('NavigationEnd:', event);
});
接下来我们可以通过路由配置的属性来获取相应的页面标题。然后,我们还需要另外两个运算符:
this.router.events
.filter(event => event instanceof NavigationEnd)
.map(() => this.activatedRoute)
.map(route => {
while (route.firstChild) route = route.firstChild;
return route;
})
.filter(route => route.outlet === 'primary') // 过滤出未命名的outlet,
.mergeMap(route => route.data) // 获取路由配置数据
.subscribe((event) => {
console.log('NavigationEnd:', event);
});
现在我们 titleService
只需要实现:
.subscribe((event) => this.titleService.setTitle(event['title']));