Angular 2 版本的 ng-bootstrap 初体验

最近 angular-ui 团队终于正式发布了基于 Angular 2 的 Bootstrap 界面库ng-bootstrap ， 工作中一直用 AngularJS 1.x 的UI Bootstrap ， 因此对这个 ng-bootstrap 也是很感兴趣， 第一时间进行试用。

准备 Angular 2 环境

ng-bootstrap 是基于 Angular 2 的， 因此需要先准备 Angular 2 的环境， 参考 Angular 2 的 5 MIN QUICKSTART 配置好 Angular 2 的环境， 这一步已经有了详细的说明， 就不在啰嗦了。

使用 ng-bootstrap

下载 ng-bootstrap

ng-bootstrap 使用 bootstrap 4.0 alpha2 ， 因此需要先下载 bootstrap ， 推荐使用 npm 包的形式：

npm install bootstrap@4.0.0-alpha.2 --save

接着下载 ng-bootstrap ， 同样使用 npm 包的形式：

npm install @ng-bootstrap/ng-bootstrap --save

修改 systemjs.config.js

现在需要修改一下 systemjs.config.js 文件， 让 SystemJS 能够正确加载 ng-bootstrap :

// map tells the System loader where to look for thingsvar map = {  'app':                        'dist', // 'dist',  '@angular':                   'node_modules/@angular',  'angular2-in-memory-web-api': 'node_modules/angular2-in-memory-web-api',  'rxjs':                       'node_modules/rxjs',  // add ng-bootstrap location map   '@ng-bootstrap':              'node_modules/@ng-bootstrap'};// packages tells the System loader how to load when no filename and/or no extensionvar packages = {  'app': { main: 'main.js',  defaultExtension: 'js', format: 'amd' },  'rxjs': { defaultExtension: 'js' },  'angular2-in-memory-web-api': { main: 'index.js', defaultExtension: 'js' },  // add ng-bootstrap package config  '@ng-bootstrap/ng-bootstrap': { main: 'index.js', defaultExtension: 'js' }};

修改 index.html

index.html 文件也要修改一下， 把 bootstrap 的样式表关联进来：

<link rel="stylesheet" href="node_modules/bootstrap/dist/css/bootstrap.css"/>

修改 app.component.ts

还需要修改一下 app.component.ts 文件， 导入 ng-bootstrap 的指令：

import { Component, OnInit } from '@angular/core';import { HTTP_PROVIDERS } from '@angular/http';import { provideRouter, ROUTER_DIRECTIVES } from '@angular/router';// import ng-bootstrap directivesimport { NGB_DIRECTIVES, NGB_PRECOMPILE } from '@ng-bootstrap/ng-bootstrap';import { routes } from './app.routes';@Component({    //moduleId: module.id,    selector: 'app',    providers: [ HTTP_PROVIDERS ],    templateUrl: 'dist/app.component.html',    styleUrls: ['dist/app.component.css'],    // ng-bootstrap required precompile directives    precompile: [NGB_PRECOMPILE],    // add ng-bootstrap directives to app    directives: [        ROUTER_DIRECTIVES, NGB_DIRECTIVES    ],    pipes: []})export class AppComponent implements OnInit {    ngOnInit() {    }}

ng-bootstrap 以指令 (directive) 的形式提供组件， 方便在 html 视图中使用， 选择器 (selector) 使用同一的前缀 ngb ， 类名则统一使用 Ngb 前缀。

接下来就可以使用 ng-bootstrap 的组件了， 接下来以 NgbAlert 为例说明 ng-bootstrap 的用法。

NgbAlert 的 selector 是 ngb-alert ， 支持的 Input 有 dismissible 和 type ， Output 有 close ， 这些输入输出的详细说明请参考 NgbAlert 的 文档 。

接下来看一个 NgbAlert 的例子：

<p>  <ngb-alert [dismissible]="false">    <strong>Warning!</strong> Better check yourself, you're not looking too good.  </ngb-alert></p>

显示效果如下：

再来一个稍微复杂一点儿的， 在 app.component.ts 文件中添加下面的代码：

export class AppComponent implements OnInit {    alert: IAlert[];    ngOnInit() {        this.alert = [            {              id: 1,              type: 'success',              message: 'This is an success alert',            },            {              id: 2,              type: 'info',              message: 'This is an info alert',            },            {              id: 3,              type: 'warning',              message: 'This is a warning alert',            },            {              id: 4,              type: 'danger',              message: 'This is a danger alert',            }        ];    }    closeAlert(alert: IAlert) {        const index: number = this.alerts.indexOf(alert);        this.alerts.splice(index, 1);    }}interface IAlert {    id: number;    type: string;    message: string;}

在对应的 html 文件中添加 *ngFor 指令， 绑定 alerts 数组：

<p *ngFor="let alert of alerts">    <ngb-alert        [type]="alert.type"        (close)="closeAlert(alert)">\{\{ alert.message }}    </ngb-alert></p>

现在得到的效果如下图所示：

ng-bootstrap 还有更多的组件， 就不一一列举了， 可以继续看：

• ng-bootstrap 官方的例子
• 我整理的一些 ng-bootstrap 的例子

小结

实现 ng-bootstrap 的人还是原来做 angular-ui 的那些人， 可以说配方还是原来的配方， 但是这味道么就跟原来有很大的不同了， 完全切换到了 Angular2 的风格。

不过总的来说， ng-bootstrap 的推出将会极大的推进 Angular 2 在实际项目中的应用， 而不只是停留在 demo 阶段， 因为 AngularJS 1.x 时期， 很多项目都是以 AngularJS + UI-Bootstrap 为基础的， 现在有了 Angular 2 的 ng-bootstrap ， 相信已经由很多人蠢蠢欲动了吧！

原创链接:http://www.tuicool.com/articles/fe6bEnQ