从零开始构建 Wijmo & Angular 2 小运用

中秋之际,Angular 团队宣告 Angular 2 正式版,Wijmo 当天宣告支撑 。着实从Angular Alpha最先,到以后 Beta版本 和 RC 版本,Wijmo 一向紧随其后。

Angular 2移除和替换了 Angular 1.X 中的 directives, controllers,modules, scopes,险些移除了 1.X 中的中心concepts 。 比拟于之前的版本,简朴地说主要有:

  • 机能极大提拔。 经由过程zone.js 中的单向绑定和数据流来庖代 1.X 中恶心的脏搜检。

  • 越发兼容挪动端。对挪动App 的衬着是基于 React Native。

  • Web Component组件化 。在1.X 版本也有组件,但着实太难写了。 在 Angular2 ,异常轻易,有点类似于 JSX 语法糖。

  • 什么 module,controller 全都没了,只要es6 中的class 。今后天下清洁许多。

  • . . .

Angular 2 真的异常优异。

Wijmo 当天支撑 Angular 2,其一切控件作为组件治理,也越发模块化和高效。

如今就最先 Wijmo 在Angular 2 中运用的第一个运用吧。

相信你已进修了 Angular 2 的Quickstart,假如没有,没紧要,由于下面的解说异常细致。源代码已上传 。

在此之前,你须要

  • 翻开 Angular 2 的中文网,来浏览它的疾速起步

  • 下载wijmoenterprise包,并翻开:
    /wijmoenterprise/Samples/TS/Angular2/FlexGridIntro/FlexGridIntro。

  • 假如你没有nodejs 环境,请先装置nodejs 环境。

1.新建我们的项目。


    $ mkdir wj-ng2-flexgrid
    $ cd wj-ng2-flexgrid

2.设置项目。

我们须要下面 3 个设置文件。

  • package.json 。 用来标记项目须要运用的npm依靠包。

  • tsconfig.json 。 这个是typescript的设置文件,定义了 TypeScript 编译器怎样从项目源文件天生 JavaScript 代码。

  • systemjs.config.js 。 为模块加载器SystemJS 供应了该到那里查找运用模块的信息,并注册了一切必备的依靠包 。(这里运用SystemJS 来设置模块,也能够运用Webpcak,神平常的利器。详情请参考博客园专家级人物 冠军 的博客: http://www.cnblogs.com/haogj/…
    假如不太邃晓设置文件中键值对的意义,能够在底部留言或许上网查询。

->>package.json


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

->> tsconfig.json


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

->> systemjs.config.js


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

装置依靠包。

在当前目次下,运转


    $ npm install 

一切依靠包会悉数下载下来,假如敕令行有正告,能够疏忽 。这些正告示意包里没有repository field,这些field仅仅用于一些包信息。

假如由于某些缘由包没法下载,那能够运用淘宝的镜像 cnpm。这个镜像会每隔10分钟和官方同步一次。

装置终了,会在项目的根目次下多出一个node_modules 文件夹,它着实是太大了 !

如今您须要将 wijmoEnterpriseSamplesTSAngular2FlexGridIntroFlexGridIntronode_moduleswijmo 文件夹拷贝到当前项目中的 node_modules 文件夹。这些文件用来将wijmo包包装为 es6 模块。

好了,如今的准备工作已完成了,您能够最先建立wijmo & Angular 2 的运用了。

3. 建立目次

玩Angular 2,起首我们须要Angular 2的脚手架。

如今来看看我的文件目次,并一一诠释。


└─ wj-ng2-flexGrid/ ······························· 项目地点目次
   ├─ node_modules/ ······························· 项目依靠包
   ├─ app/ ········································ 运用顺序子目次
   │  ├─ components/ ······························ 组件目次
   │  │  ├─ app.component.html ···················· 根组件app.Component模板
   │  │  └─ app.conponent.ts ······················ 根组件app.Component
   │  ├─ services/ ································ 效劳目次
   │  │  └─ data.service.ts ······················· 数据效劳 data.Service
   │  ├─ app.module.ts ···························· 根模块app.module
   │  └─ main.ts ·································· Angular 指导文件
   ├─ scripts/ ···································· 外部js 目次
   │  ├─ definition/ ······························ wijmo 模块定义目次
   │  └─ vendor/ ·································· wijmo 剧本目次
   ├─ styles/ ····································· 款式目次
   ├─ index.html ·································· 运用宿主页面
   ├─ package.json ································ npm 依靠列表
   ├─ systemjs.config.js ·························· systemJS 设置
   ├─ tsconfig.js ································· TypeScript 设置
   └─ readme.md ··································· 顺序说明

 

这看起来好像比较复杂,然则却很有条理。

4. 编写宿主页面

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


    <html>
    <head>
        <meta charset="UTF-8">
        <title>运用 Angular 2 来建立FlexGrid控件</title>
        <!--angular 2 模块最先 -->
        <!--用于添补旧版浏览器-->
        <script src="node_modules/core-js/client/shim.min.js"></script>
        <script src="node_modules/zone.js/dist/zone.js"></script>
        <script src="node_modules/reflect-metadata/Reflect.js"></script>
        <script src="node_modules/systemjs/dist/system.src.js"></script>
        <!--systemjs 设置最先-->
        <script src="systemjs.config.js"></script>
        
        <!--wijmo 模块最先-->
        <script src="scripts/vendor/wijmo.min.js"></script>
        <script src="scripts/vendor/wijmo.grid.min.js"></script>
        <link rel="stylesheet" href="styles/wijmo.min.css">
        <script src="scripts/vendor/wijmo.angular2.min.js"></script>
        <!--mine-->
        <script>
          System.import('./app/main').catch(function(err){ console.error(err); });
        </script>
    </head>
    <body>
        <!--说明根组件-->
        <app-cmp>
            Loading ...
        </app-cmp>
    </body>
    </html>

5. 编写数据效劳

这个页面定义终了,如今来编写一个数据效劳。这个数据效劳须要被注入到组件中,因而须要引入一个元标记 Injectable 。

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


    'use strict'
    import { Injectable } from '@angular/core';
    @Injectable()
    export class DataService {
        getData(count: number): wijmo.collections.ObservableArray {
            var countries = 'US,Germany,UK,Japan,Italy,Greece'.split(','),
                data = new wijmo.collections.ObservableArray();
            for (var i = 0; i < count; i++) {
                data.push({
                    id: i,
                    country: countries[i % countries.length],
                    date: new Date(2014, i % 12, i % 28),
                    amount: Math.random() * 10000,
                    active: i % 4 == 0
                });
            }
            return data;
        }
    }

6. 编写根组件和模块

如今我们编写运用的第一个组件:根组件 app.component ,也是这个顺序唯一的组件。


    import { Component, Inject } from '@angular/core';
    import { DataService } from '../services/data.service';
    @Component ({
        selector:'app-cmp',
        templateUrl:'app/components/app.component.html',
    })
    export class  AppComponent{
        protected dataSvc:DataService;
        data: wijmo.collections.CollectionView;
        constructor(@Inject(DataService) dataSvc:DataService){
            this.dataSvc = dataSvc;
            this.data = new wijmo.collections.CollectionView(this.dataSvc.getData(50));
        }
    }

在这个组件中,须要引入两个元标记。Component, Inject ,还须要注入定义的数据效劳data.Service。

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


    <div class="header">
        <h2>
            这个页面展现了怎样在angular 2上运用 Wijmo。
        </h2>
    </div>
    <div>
    <wj-flex-grid [itemsSource]="data">  </wj-flex-grid>
    </div>

在这里,仅仅须要引入一个 wj-flex-grid 标记,就能够建立一个 flexgrid控件了,wj-flex-grid 组件是作为一个子组件存在的,在app.module 模块中注入。

itemsSource 绑定一个数据源,这个itemsSource是flexgrid已封装完成的属性。在 flexgrid 内部是经由过程 @Input 来完成的。

在根模块中将组件注入


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

在这里,须要将援用的一切的组件和模块都要注入进来。

7. 指导和启动援用

末了是指导顺序 main.ts


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

在根目次下,运转


    $ npm start

这时候,顺序会自动翻开默许浏览器并衬着页面。

start 敕令是实行定义在 package.json 文件中的scripts敕令。 会将ts代码编译为原生js,并且会启动一个静态效劳器。 这个效劳器会检测文件的变化,当发明文件修改,那末会自动编译ts代码。

结果截图。

下载源代码

    原文作者:apawn
    原文地址: https://segmentfault.com/a/1190000007419987
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞