Wijmo Angular 2 小应用

Wijmo & Angular 2 小应用

中秋之际,Angular 团队发布 Angular 2 正式版,一款不错的图表控件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/p/5998556.html#3541215
    如果不太明白配置文件中键值对的意义,可以在底部留言或者上网查询。

->>package.json

{

  "name": "wj-ng2-flexgrid",
  "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 文件夹,它实在是太大了 !

现在您需要将 \wijmoEnterprise\Samples\TS\Angular2\FlexGridIntro\FlexGridIntro\node_modules\wijmo 文件夹拷贝到当前项目中的 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代码。



效果截图。

下载源代码

时间: 2024-11-10 15:09:11

Wijmo Angular 2 小应用的相关文章

angular ngRoute小例子

ngRoute学习小例子 单页面应用中可以使用ng-view,当修改ng-view的template时可以实现一个页面html中展示不同内容(div部分). 例如index.html中包含ng-view 1 <!DOCTYPE HTML> 2 <html ng-app="app"> 3 <head> 4 <script src="./bower_components/angular/angular.js"></s

关于angular中函数的先后执行之我见(以及angular的小bug)

在js中,函数的先后执行 (1)在angular中假设有这个场景,对表单资料进行编辑,刚好这个表单有select选项需要从后台中获取,这个时候这个表单使用angular进行开发的时候的正确打开方式应该是 先加载select选项,在加载表单的对应内容(由于http是异步的,并不是单纯的把js顺序调整一下就可以的) 这时候可以使用angular自带的$q返回promise来控制函数运行, 如果函数中没有其他的异步,简单粗暴的使用$timeout来控制 (2)input[type=hidden]使用n

angular.js小知识总结

angular-watch.html 代码如下: <script> var app = angular.module('app',[]); app.controller('ctrl',function($scope){ $scope.init = { price : 20,//单价 count : 5, //数量 money : 3 //运费 }; $scope.a = 0; $scope.$watch('init.count',function(newVal,oldVal){ console

Angular开发小笔记

一.父组件怎么覆盖子组件的样式呢 1./deep/(不建议这么做,以后angular会取消,因为这样写不利于组件的独立性) 在父组件的scss里面写: :host{ 子组件名 /deep/ label{ color:red } } 这样就可以覆盖掉子组件label的color了 2.host和host-context 在子组件的scss里面写: :host(.自身加的class){ label{ color:red; } } 或者 :host-context(父组件名){ label{ colo

angular之控制器(0)

一.控制器的含义 在angularJS中,controlle是一个javascript函数/类,用于操作作用域中,各个对象的初始状态以及相应的行为 二.控制器的作用 1. 控制 AngularJS 应用程序的数据 2.对$scope对象进行初始化(可以理解为每个控制器都对应一个$scope,每个控制器里面的$scope都是互相封闭的,互不影响..除了嵌套控制器.留在以后讲$scope的作用域) 三.控制器的意义 通过控制器实现代码的业务逻辑代码. 注意:控制器的设计出发点是封装单个视图的业务逻辑

Mobile first! Wijmo 5 + Ionic Framework之:Hello World!

?? 本教程中,我们用Wijmo 5 和 Ionic Framework实现一个Mobile的工程:Hello World. Ionic是什么? Ionic是一个HTML5框架.免费.开源,用于帮助生成hybird mobile Apps (混合移动应用). Ionic包含3部分: CSS 样式:用于渲染Web页面,使得页面更接近原生移动应用 (Native App). AngularJS:Ionic使用AngularJs的扩展指令作为核心框架库,同时AngularJs也加快了开发过程. Apa

angular.js 渲染

angular.js 小常识   具体看代码,转载请备注来源. html结构 <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ include file="../host.jsp"%> <%@ include file="../common.jsp"

关于Angular 指令的理解

之前虽然一直都在用这套框架,但是对于指令还是知之甚少,感觉是蛮复杂的东西.看了之后也没有真正理解. 最近在做一个Angular的小项目,卡在了Angular的生命周期和自定义指令上.纠结了好几天,终于今天在地铁上灵光一闪想通了.所以赶紧把它记下来,免得后面忘记了. 我们一直都说angular的加载流程是先载入HTML片段,其中在加载<script>标签的时候加载了所有的JS库,包括我们自己写的所有的controller/service/filter以及官方的angular库. 加载完angul

基于ANGULAR.JS的下一代WEB应用开发-01-yeoman

Angularjs 个人认为这是一款很好的框架!它将我们从AJAX应用的开发中解救了出来!嗯....废话就说道这里下面我们开始把! 首先我们必须了解一些核心的概念: 客户端模版 MVC 数据绑定 依赖注入 指令 先不要着急,了解这些词语的意思和含义,万丈高楼平地起我们慢慢来构建一个属于我们自己的小应用. 确定我们的目标 首先我们必须确定自己要做什么?做个什么呢?YOUKU TUDOU那样的视频网站,哦,拜托杀了我把,我只想了解下这个东西,嗯!那就写个简单的博客吧!你还是杀了我把,由于本人太懒,所