伴随着 Angular 2 的正式 release,Kendo UI for Angular 2 的第一批控件已经发布了,当前是 Beta 版本,免费使用。
Kendo UI for Angular 被打包成独立的多个 NPM package,在 Progress NPM 之下 ( https://registry.npm.telerik.com/ ), 要想访问它,你需要一个激活的 Telerik account , 如果你现在还没有这个账号,可以到这里创建一个,这是免费的。这些包在 @progress 之下。例如,Grid 控件包的名字是 @progress/kendo-angular-grid.
安装
为了在你的机器上启用 Progress registry,你应该关联 @progress 到 registry URL 上,在命令行终端中,执行下面的命令。
npm login --registry=https://registry.npm.telerik.com/ --scope=@progress
NPM 将会询问你的 Telerik 账号和邮件,在 Username 中输入你的用户名 (如果你的用户名是一个邮件地址,仅仅输入 @ 之前的部分),Password 就是你的 Telerik 账号口令。
验证
如果上面的命令成功执行了,你应该可以安装 Kendo UI 的 NPM Package 了,可以先查询一下 Grid 控件的版本进行检查。
npm view @progress/kendo-angular-grid versions
输出结果应该类似下面的输出。
>npm view @progress/kendo-angular-grid versions [ '0.2.1', '0.2.2', '0.3.0', '0.3.1' ]
将组件添加到你的项目中
Kendo UI for Angular 2 的组件被组织为多个 NPM Package。它们的命名规则为 @progress/kendo-angular-grid
, @progress/kendo-angular-inputs 等等。我们先添加 Buttons 的组件包。
在你的项目根目录中,执行下面的命令
npm install -S @progress/kendo-angular-buttons
稍等一会,如果 NPM 正常完成了安装,这个包和它所依赖的包将会被安装到你的项目中。
然后,导入组件到你的项目中,假设你正在使用 Angular 2 官方提供的 5 分钟快速上手。如果你还没有这个项目,可以访问这里:https://github.com/telerik/kendo-angular2-quickstart
修改一下 app.module.ts 文件,如下所示。
import { NgModule } from '@angular/core'; import { BrowserModule } from '@angular/platform-browser'; import { ButtonsModule } from '@progress/kendo-angular-buttons'; import { AppComponent } from './app.component'; @NgModule({ imports: [ BrowserModule, ButtonsModule ], declarations: [ AppComponent ], bootstrap: [ AppComponent ] }) export class AppModule { }
然后,修改 app.component.ts,添加一个按钮。
import { Component } from '@angular/core'; @Component({ selector: 'my-app', template: `My First Kendo UI Angular 2 App
` }) export class AppComponent { onButtonClick() { alert('Hello from Kendo UI!'); } }
添加样式
可以有多种方式将 Kendo UI 的 theme 包含到项目中,我们建议使用 Webpack 和 Sass loader,这种方式支持使用 Sass 变量来定制 Kendo Ui 的 theme。
这里,我们简单一点,直接在 Component 中使用 StyleUrls 来引入样式。
import { Component } from '@angular/core'; @Component({ selector: 'my-app', styleUrls: [ '../node_modules/@progress/kendo-angular-buttons/dist/npm/css/main.css' ], // load the button theme template: `My First Kendo UI Angular 2 App
`, }) export class AppComponent { onButtonClick() { alert('Hello from Kendo UI!'); } }
当样式到位之后,你的应用看起来应该如下所示了。
按钮被完全支持了,并且看起来很气派!