使用Wijmo & Angular 2 创建 FlexChart

上次我们使用 Wijmo 和 Angular 2 创建了第一个小应用，从零开始构建 Wijmo & Angular 2 小应用，现在就来看看如何使用 Wijmo & Angular 2 构建一个 FlexChart 。

1.新建我们的项目。

$ mkdir wj-ng2@H_403_6@-flexgrid@H_403_6@
$ cd wj-ng2@H_403_6@-flexgrid@H_403_6@

2.配置项目。

我们需要下面 3 个配置文件。

package.json 。用来标记项目需要使用的npm依赖包。
tsconfig.json 。这个是typescript的配置文件，定义了 TypeScript 编译器如何从项目源文件生成 JavaScript 代码。
systemjs.config.js 。为模块加载器SystemJS 提供了该到哪里查找应用模块的信息，并注册了所有必备的依赖包。（这里使用SystemJS 来配置模块，也可以使用Webpcak，神一般的利器。详情请参考博客园专家级人物冠军的博客： http://www.cnblogs.com/haogj/p/5998556.html#3541215）
如果不太明白配置文件中键值对的意义，可以在底部留言或者上网查询。

->>package.json

{
  "name@H_403_6@": "wj-ng2-flexchart"@H_403_6@@H_403_6@,"version@H_403_6@": "1.0.0"@H_403_6@@H_403_6@,"scripts@H_403_6@": { "start@H_403_6@": "tsc && concurrently \"tsc -w\" \"lite-server\" "@H_403_6@@H_403_6@,"lite@H_403_6@": "lite-server"@H_403_6@@H_403_6@,"tsc@H_403_6@": "tsc"@H_403_6@@H_403_6@,"tsc:w@H_403_6@": "tsc -w"@H_403_6@ @H_403_6@}@H_403_6@,"licenses@H_403_6@": [ { "type@H_403_6@": "MIT"@H_403_6@@H_403_6@,"url@H_403_6@": "https://github.com/angular/angular.io/blob/master/LICENSE"@H_403_6@ @H_403_6@} ]@H_403_6@,"dependencies@H_403_6@": { "@angular/common@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"@angular/compiler@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"@angular/core@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"@angular/forms@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"@angular/http@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"@angular/platform-browser@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"@angular/platform-browser-dynamic@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"@angular/router@H_403_6@": "~3.1.1"@H_403_6@@H_403_6@,"@angular/upgrade@H_403_6@": "~2.1.1"@H_403_6@@H_403_6@,"angular-in-memory-web-api@H_403_6@": "~0.1.13"@H_403_6@@H_403_6@,"core-js@H_403_6@": "^2.4.1"@H_403_6@@H_403_6@,"reflect-Metadata@H_403_6@": "^0.1.8"@H_403_6@@H_403_6@,"rxjs@H_403_6@": "5.0.0-beta.12"@H_403_6@@H_403_6@,"systemjs@H_403_6@": "0.19.39"@H_403_6@@H_403_6@,"zone.js@H_403_6@": "^0.6.25"@H_403_6@ @H_403_6@}@H_403_6@,"devDependencies@H_403_6@": { "@types/core-js@H_403_6@": "^0.9.34"@H_403_6@@H_403_6@,"@types/node@H_403_6@": "^6.0.45"@H_403_6@@H_403_6@,"concurrently@H_403_6@": "^3.0.0"@H_403_6@@H_403_6@,"lite-server@H_403_6@": "^2.2.2"@H_403_6@@H_403_6@,"typescript@H_403_6@": "^2.0.3"@H_403_6@ @H_403_6@} @H_403_6@}

->> tsconfig.json

{
  "compilerOptions@H_403_6@": { "target@H_403_6@": "es5"@H_403_6@@H_403_6@,"module@H_403_6@": "commonjs"@H_403_6@@H_403_6@,"moduleResolution@H_403_6@": "node"@H_403_6@@H_403_6@,"sourceMap@H_403_6@": true@H_403_6@@H_403_6@,"emitDecoratorMetadata@H_403_6@": true@H_403_6@@H_403_6@,"experimentalDecorators@H_403_6@": true@H_403_6@@H_403_6@,"removeComments@H_403_6@": false@H_403_6@@H_403_6@,"noImplicitAny@H_403_6@": false@H_403_6@ @H_403_6@} @H_403_6@}

->> systemjs.config.js

/** * System configuration for Angular samples * Adjust as necessary for your application needs. */@H_403_6@
(function@H_403_6@ (global)@H_403_6@ {@H_403_6@
  System.config({
    paths: {
      // paths serve as alias@H_403_6@
      'npm:'@H_403_6@: 'node_modules/'@H_403_6@
    },// map tells the System loader where to look for things@H_403_6@
    map: {
      // our app is within the app folder@H_403_6@
      app: 'app'@H_403_6@,// angular bundles@H_403_6@
      '@angular/core'@H_403_6@: 'npm:@angular/core/bundles/core.umd.js'@H_403_6@,'@angular/common'@H_403_6@: 'npm:@angular/common/bundles/common.umd.js'@H_403_6@,'@angular/compiler'@H_403_6@: 'npm:@angular/compiler/bundles/compiler.umd.js'@H_403_6@,'@angular/platform-browser'@H_403_6@: 'npm:@angular/platform-browser/bundles/platform-browser.umd.js'@H_403_6@,'@angular/platform-browser-dynamic'@H_403_6@: 'npm:@angular/platform-browser-dynamic/bundles/platform-browser-dynamic.umd.js'@H_403_6@,'@angular/http'@H_403_6@: 'npm:@angular/http/bundles/http.umd.js'@H_403_6@,'@angular/router'@H_403_6@: 'npm:@angular/router/bundles/router.umd.js'@H_403_6@,'@angular/forms'@H_403_6@: 'npm:@angular/forms/bundles/forms.umd.js'@H_403_6@,'@angular/upgrade'@H_403_6@: 'npm:@angular/upgrade/bundles/upgrade.umd.js'@H_403_6@,// other libraries@H_403_6@
      'rxjs'@H_403_6@:                      'npm:rxjs'@H_403_6@,'angular-in-memory-web-api'@H_403_6@: 'npm:angular-in-memory-web-api/bundles/in-memory-web-api.umd.js'@H_403_6@
    },// packages tells the System loader how to load when no filename and/or no extension@H_403_6@
    packages: {
      app: {
        main: './main.js'@H_403_6@,defaultExtension: 'js'@H_403_6@
      },rxjs: {
        defaultExtension: 'js'@H_403_6@
      }
    }
  });
})(this@H_403_6@);

安装依赖包。

在当前目录下，运行

$ @H_403_6@npm install

所有依赖包会全部下载下来，如果命令行有警告，可以忽略。这些警告表示包里没有repository field，这些field仅仅用于一些包信息。

如果因为某些原因包无法下载，那可以使用淘宝的镜像 cnpm。这个镜像会每隔10分钟和官方同步一次。

安装结束，会在项目的根目录下多出一个node_modules 文件夹，它实在是太大了！

现在您需要将 \wijmoEnterprise\Samples\TS\Angular2\FlexGridIntro\FlexGridIntro\node_modules\wijmo 文件夹拷贝到当前项目中的 node_modules 文件夹。这些文件用来将wijmo包包装为 es6 模块。

好了，现在的准备工作已经完成了，您可以开始创建wijmo & Angular 2 的应用了。

3. 创建目录

玩Angular 2，首先我们需要Angular 2的脚手架。

现在来看看我的文件目录，并逐一解释。

└─ wj-ng2-flexchart/ ······························· 项目所在目录
   ├─ node_modules/ ······························· 项目依赖包
   ├─ app/ ········································ 应用程序子目录
   │  ├─ components/ ······························ 组件目录
   │  │  ├─ app.component@H_403_6@.html@H_403_6@ ···················· 根组件app.Component@H_403_6@模板
   │  │  └─ app.conponent@H_403_6@.ts@H_403_6@ ······················ 根组件app.Component@H_403_6@
   │  ├─ services/ ································ 服务目录
   │  │  └─ data.service@H_403_6@.ts@H_403_6@ ······················· 数据服务 data.Service@H_403_6@
   │  ├─ app.module@H_403_6@.ts@H_403_6@ ···························· 根模块app.module@H_403_6@
   │  └─ main.ts@H_403_6@ ·································· Angular 引导文件
   ├─ scripts/ ···································· 外部js 目录
   │  ├─ definition/ ······························ wijmo 模块定义目录
   │  └─ vendor/ ·································· wijmo 脚本目录
   ├─ styles/ ····································· 样式目录
   ├─ index.html@H_403_6@ ·································· 应用宿主页面
   ├─ package.json@H_403_6@ ································ npm 依赖列表
   ├─ systemjs.config@H_403_6@.js@H_403_6@ ·························· systemJS 配置
   ├─ tsconfig.js@H_403_6@ ································· TypeScript 配置
   └─ readme.md@H_403_6@ ··································· 程序说明

这看起来似乎比较复杂，但是却很有条理。

4. 编写宿主页面

在宿主页面中，除了Angular 2中必须的组件，还需要引入Wijmo js脚本。

<html@H_403_6@>@H_403_6@
<head@H_403_6@>@H_403_6@
    <Meta@H_403_6@ charset@H_403_6@="UTF-8"@H_403_6@>@H_403_6@
    <title@H_403_6@>@H_403_6@使用 Angular 2 来创建FlexGrid控件</title@H_403_6@>@H_403_6@
    <!--angular 2 模块开始 -->@H_403_6@
    <!--用于填充旧版浏览器-->@H_403_6@
    <script@H_403_6@ src@H_403_6@="node_modules/core-js/client/shim.min.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@
    <script@H_403_6@ src@H_403_6@="node_modules/zone.js/dist/zone.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@
    <script@H_403_6@ src@H_403_6@="node_modules/reflect-Metadata/Reflect.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@
    <script@H_403_6@ src@H_403_6@="node_modules/systemjs/dist/system.src.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@
    <!--systemjs 配置开始-->@H_403_6@
    <script@H_403_6@ src@H_403_6@="systemjs.config.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@

    <!--wijmo 模块开始-->@H_403_6@
    <script@H_403_6@ src@H_403_6@="scripts/vendor/wijmo.min.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@
    <script@H_403_6@ src@H_403_6@="scripts/vendor/wijmo.chart.min.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@
    <link@H_403_6@ rel@H_403_6@="stylesheet"@H_403_6@ href@H_403_6@="styles/wijmo.min.css"@H_403_6@>@H_403_6@
    <script@H_403_6@ src@H_403_6@="scripts/vendor/wijmo.angular2.min.js"@H_403_6@>@H_403_6@@H_403_6@</script@H_403_6@>@H_403_6@
    <!--mine-->@H_403_6@
    <script@H_403_6@>@H_403_6@ System.import('./app/main'@H_403_6@).catch(function@H_403_6@(err)@H_403_6@{@H_403_6@ console.error(err); }); @H_403_6@</script@H_403_6@>@H_403_6@
</head@H_403_6@>@H_403_6@
<body@H_403_6@>@H_403_6@
    <!--申明根组件-->@H_403_6@
    <app-cmp@H_403_6@>@H_403_6@
        Loading ...
    </app-cmp@H_403_6@>@H_403_6@
</body@H_403_6@>@H_403_6@
</html@H_403_6@>@H_403_6@

5. 编写数据服务

这个页面定义完毕，现在来编写一个数据服务。这个数据服务需要被注入到组件中，因此需要引入一个元标记 Injectable 。

data.Service 返回一些国家相关信息的随机数据。

'use strict'@H_403_6@

import { Injectable } from '@angular/core'@H_403_6@;

@Injectable()
export class@H_403_6@ DataService {
    getData(countries: string[]): any[] {
        var@H_403_6@ data = [];
        for@H_403_6@ (let@H_403_6@ i = 0@H_403_6@; i < countries.length; i++) {
            data.push({
                country: countries[i],downloads: Math@H_403_6@.round(Math@H_403_6@.random() * 20000@H_403_6@),sales: Math@H_403_6@.random() * 10000@H_403_6@,expenses: Math@H_403_6@.random() * 5000@H_403_6@
            });
        }
        return@H_403_6@ data;
    };
}

6. 编写根组件和模块

现在我们编写应用的第一个组件：根组件 app.component,也是这个程序唯一的组件。

import { Component,Inject } from '@angular/core'@H_403_6@;
import { DataService } from '../services/data.service'@H_403_6@;

@Component({
    selector: 'app-cmp'@H_403_6@,templateUrl: 'app/components/app.component.html'@H_403_6@,})
export class@H_403_6@ AppComponent {
    protected dataSvc: DataService;
    countries = 'US,Germany,UK,Japan,Italy,Greece'@H_403_6@.split(','@H_403_6@);
    data: { country: string,downloads: number,sales: number,expenses: number }[];

    constructor( @Inject(DataService) dataSvc: DataService) {
        this@H_403_6@.dataSvc = dataSvc;
        this@H_403_6@.data = this@H_403_6@.dataSvc.getData(this@H_403_6@.countries);
    }
}

在这个组件中，需要引入两个元标记。Component,Inject ，还需要注入定义的数据服务data.Service。

在组件app.component.html模板中，

<div@H_403_6@>@H_403_6@
    <wj-flex-chart@H_403_6@ [itemsSource@H_403_6@]="data"@H_403_6@ [bindingX@H_403_6@]="'country'"@H_403_6@>@H_403_6@
        <wj-flex-chart-series@H_403_6@ [name@H_403_6@]="'Sales'"@H_403_6@ [binding@H_403_6@]="'sales'"@H_403_6@>@H_403_6@</wj-flex-chart-series@H_403_6@>@H_403_6@
        <wj-flex-chart-series@H_403_6@ [name@H_403_6@]="'Expenses'"@H_403_6@ [binding@H_403_6@]="'expenses'"@H_403_6@>@H_403_6@</wj-flex-chart-series@H_403_6@>@H_403_6@
        <wj-flex-chart-series@H_403_6@ [name@H_403_6@]="'Downloads'"@H_403_6@ [binding@H_403_6@]="'downloads'"@H_403_6@>@H_403_6@</wj-flex-chart-series@H_403_6@>@H_403_6@
    </wj-flex-chart@H_403_6@>@H_403_6@
</div@H_403_6@>@H_403_6@

在这里，仅仅需要引入一个 wj-flex-grid 标记，就可以创建一个 flexgrid控件了，wj-flex-grid 组件是作为一个子组件存在的，在app.module 模块中注入。
通过wj-flex-chart-series 来申明系列，通过bindling 来指定绑定的字段。
itemsSource 绑定一个数据源，这个itemsSource是flexgrid已经封装完成的属性。在 flexgrid 内部是通过 @Input 来完成的。

在根模块中将组件注入

import {   NgModule } from '@angular/core'@H_403_6@;
import { BrowserModule } from '@angular/platform-browser'@H_403_6@;
import { WjGridModule } from 'wijmo/wijmo.angular2.grid'@H_403_6@;
import { AppComponent } from './components/app.component'@H_403_6@;
import { DataService } from './services/data.service'@H_403_6@;
@NgModule({
    imports: [ WjGridModule,BrowserModule],declarations: [AppComponent],providers:[DataService],bootstrap: [AppComponent],})
export class@H_403_6@ AppModule { }

在这里，需要将引用的所有的组件和模块都要注入进来。

7. 引导和启动引用

最后是引导程序 main.ts

import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'@H_403_6@;
import {enableProdMode} from '@angular/core'@H_403_6@;
import { AppModule } from './app.module'@H_403_6@;
enableProdMode();
platformBrowserDynamic().bootstrapModule(AppModule);

在根目录下，运行

$ @H_403_6@npm start

这时，程序会自动打开默认浏览器并渲染页面。

start 命令是执行定义在 package.json 文件中的scripts命令。会将ts代码编译为原生js，并且会启动一个静态服务器。这个服务器会检测文件的变化，当发现文件改动，那么会自动编译ts代码。

http://images2015.cnblogs.com/blog/857465/201611/857465-20161109111636561-530904138.png” alt=”效果截图” title=”” />