再遇angular（angular4项目实战指南）

时间 2019-12-19

标签 angular angular4 项目实战指南栏目 AngularJS 繁體版

原文原文链接

这两天看了看angular4的文档，发现他和angular1.X的差异真的是太大了，官方给出的那个管理英雄的Demo是一个很是好的入门项目，这里给出一个管理我的计划的小项目，从头到尾一步一步讲解如何去实现他，但愿对你有所帮助。这篇文章不会讲解如何去用angular4，这部分东西你能够参考官网，本文讲解的是用angular作一个小项目的全过程。写的比较仓促，疏漏不免，请各位多多指点。css

本项目是angular4.0的一个Demo，能够实现对我的计划的管理。目的是分享一下我的作一个angular项目的通常作法，但愿能为一些朋友提供参考。项目参考了vue-tutorial，在此对原做者表示感谢。html

git地址：https://github.com/yibingxiong/ng-plan
博客地址：http://www.cnblogs.com/floor/前端

项目架构

开发过程详解

本开发过程不对angular4.0的使用进行详细讲解，一些基本概念和一些工具的安装使用请参考官网vue

1. 初始化项目

使用angular-cli搭建项目
ng new ng-plan
启动项目
- cd ng-plan
- ng serve
访问localhost:4200/查看效果

若是可以看到这个效果证实你完成了天才第一步（不是雀式纸尿裤哦）

2. 作一个首页

引入bootstrap样式库

为了简化样式编写，直接用个第三方库bootstrap，在/src/index.html的heade引入，以下
<link href="http://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">git

修改/src/app/app.component.html

<nav class="navbar navbar-default">
  <div class="container">
    <div class="navbar-header">
      <a class="navbar-brand" href="#">
          <i class="glyphicon glyphicon-time"></i>
          计划板
        </a>
    </div>
    <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
      <ul class="nav navbar-nav">
        <li class="active"><a href="#">首页</a></li>
        <li><a href="#">计划列表</a></li>
      </ul>
    </div>
  </div>
</nav>
<div class="container">
  <div class="col-sm-3">
    <div class="panel panel-default">
      <div class="panel-heading">
        <h1 class="text-center">已有时长</h1>
      </div>
      <div class="panel-body">
        <h1 class="text-center">1 小时</h1>
      </div>
    </div>
  </div>
  <div class="col-sm-9">
    <div class="jumbotron">
      <h1>任务追踪</h1>
      <p>
        <strong>
          <a href="#">建立一个任务</a>
        </strong>
      </p>
    </div>
  </div>
</div>

效果以下github

3. 本身动手作一个组件

使用angular-cli建立组件 ng g component navigation

将/src/app/app.component.html中的导航部分移到/src/app/navigation/navigation.component.html

使用咱们的navigation组件

从上图能够看见使用命令行建立组件，组件会被自动注册到根模块中，因此直接使用就能够了
直接在/src/app/app.component.html最上边加上bootstrap

<app-navigation></app-navigation>

若是不出现意外的话，你看到的效果应该和2中效果同样，那为何要这样作呢？方便维护，便于复用。在这个小项目你可能并不能看出他的好处，并且本项目将导航作成独立组件没有太大意义。架构

4. 作个路由

在app.module.ts中导入路由模块

import { RouterModule }   from '@angular/router';

配置咱们的路由

如今咱们的/src/app/module.ts应该是下边这个样子app

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { RouterModule } from '@angular/router';

import { AppComponent } from './app.component';
import { NavigationComponent } from './navigation/navigation.component';

@NgModule({
  declarations: [
    AppComponent,
    NavigationComponent,
  ],
  imports: [
    BrowserModule,
    RouterModule.forRoot([
      { path: '', redirectTo: '/home', pathMatch: 'full' },
      { path: 'home',  component: HomeComponent },
    ])
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

能够看到imports中作了路由配置，此时运行会出错，由于尚未Home组件angular4

指定路由出口

将/src/app/app.component.html改成以下

<app-navigation></app-navigation>
<div class="container">
  <div class="col-sm-3">
    <div class="panel panel-default">
      <div class="panel-heading">
        <h1 class="text-center">已有时长</h1>
      </div>
      <div class="panel-body">
        <h1 class="text-center">1 小时</h1>
      </div>
    </div>
  </div>
  <div class="col-sm-9">
    <router-outlet></router-outlet>
  </div>
</div>

能够发现一部份内容被替换为<router-outlet></router-outlet>这样，路由匹配的内容将会在这里显示。

建立Home组件

上边发现咱们home找不到，如今建立这个组件，与上边建立navigation是相似的
直接运行

ng g component home

angular-cli会帮咱们作好一切
运行效果以下

下面修改咱们的Home组件，更改他的html文件以下

<div class="jumbotron">
  <h1>任务追踪</h1>
  <p>
    <strong>
      <a>建立一个任务</a>
    </strong>
  </p>
</div>

效果以下

发现和前面的效果基本同样了，不过不要着急，咱们慢慢来！

5. 建立计划列表页

这其实仍是建立一个组件，因此咱们仍是用命令行来搞！

第一步

ng g component plan-list

第二步加到路由（修改app.module.ts）

{ path: 'planlist', component: PlanListComponent },

第三步测试一下（访问：http://localhost:4200/planlist）

没毛病！

第四步完善计划列表
- 修改/src/app/plan-list/plan-list.component.html

<div class="time-entries">
  <div class="list-group">
    <a class="list-group-item">
      <div class="row">
        <div class="col-sm-2 user-details">
          <img src="http://pic.dfhon.com/pictures/20100401/141048.jpg" class="avatar img-circle img-responsive" />
          <p class="text-center">
            <strong>
              大熊
            </strong>
          </p>
        </div>
        <div class="col-sm-2 text-center time-block">
          <h3 class="list-group-item-text total-time">
            <i class="glyphicon glyphicon-time"></i>
            1
          </h3>
          <p class="label label-primary text-center">
            <i class="glyphicon glyphicon-calendar"></i>
            2017-08-04
          </p>
        </div>
        <div class="col-sm-7 comment-section">
          必定要完成
        </div>
        <div class="col-sm-1">
          <button class="btn btn-xs btn-danger delete-button">
          X
          </button>
        </div>
      </div>
    </a>
    <a class="list-group-item">
      <div class="row">
        <div class="col-sm-2 user-details">
          <img src="http://pic.dfhon.com/pictures/20100401/141048.jpg" class="avatar img-circle img-responsive" />
          <p class="text-center">
            <strong>
              大熊
            </strong>
          </p>
        </div>
        <div class="col-sm-2 text-center time-block">
          <h3 class="list-group-item-text total-time">
            <i class="glyphicon glyphicon-time"></i>
            1
          </h3>
          <p class="label label-primary text-center">
            <i class="glyphicon glyphicon-calendar"></i>
            2017-08-04
          </p>
        </div>
        <div class="col-sm-7 comment-section">
          必定要完成
        </div>
        <div class="col-sm-1">
          <button class="btn btn-xs btn-danger delete-button">
          X
          </button>
        </div>
      </div>
    </a>
  </div>
</div>

修改/src/app/plan-list/plan-list.component.css

.avatar {
      height: 75px;
      margin: 0 auto;
      margin-top: 10px;
      margin-bottom: 10px;
}
.user-details {
      background-color: #f5f5f5;
      border-right: 1px solid #ddd;
      margin: -10px 0;
}
.time-block {
    padding: 10px;
}
.comment-section {
    padding: 20px;
}

查看效果

5. 让导航可点

目前咱们的导航还不能点击，下面解决这个问题，修改/src/app/navigation/navigation.component.html

<nav class="navbar navbar-default">
  <div class="container">
    <div class="navbar-header">
      <a class="navbar-brand" routerLink="/" routerLinkActive="active">
          <i class="glyphicon glyphicon-time"></i>
          计划板
        </a>
    </div>
    <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
      <ul class="nav navbar-nav">
        <li routerLinkActive="active"><a routerLink="/home">首页</a></li>
        <li routerLinkActive="active"><a routerLink="/planlist" >计划列表</a></li>
      </ul>
    </div>
  </div>
</nav>

这样你就能够在首页和计划列表点来点去了。

6. 用假数据渲染planlist

修改/src/app/plan-list/plan-list.component.ts提供数据

import { Component, OnInit } from '@angular/core';

@Component({
  selector: 'app-plan-list',
  templateUrl: './plan-list.component.html',
  styleUrls: ['./plan-list.component.css']
})
export class PlanListComponent implements OnInit {
  plans = [
    {
      name: '大熊',
      date: '2017-8-8',
      totalTime: 1,
      comment: '学习到天亮'
    },
    {
      name: '大熊',
      date: '2017-8-8',
      totalTime: 1,
      comment: '学习到天亮'
    },
    {
      name: '大熊',
      date: '2017-8-8',
      totalTime: 1,
      comment: '学习到天亮'
    }
  ];

  constructor() { }

  ngOnInit() {
  }

}

使用ngFor渲染列表，修改/src/app/plan-list/plan-list.component.html

<div class="time-entries">
  <div class="list-group">
    <a class="list-group-item" *ngFor="let plan of plans">
      <div class="row">
        <div class="col-sm-2 user-details">
          <img src="http://pic.dfhon.com/pictures/20100401/141048.jpg" class="avatar img-circle img-responsive" />
          <p class="text-center">
            <strong>
             {{plan.name}}
            </strong>
          </p>
        </div>
        <div class="col-sm-2 text-center time-block">
          <h3 class="list-group-item-text total-time">
            <i class="glyphicon glyphicon-time"></i>
            {{plan.totalTime}}
          </h3>
          <p class="label label-primary text-center">
            <i class="glyphicon glyphicon-calendar"></i>
            {{plan.date}}
          </p>
        </div>
        <div class="col-sm-7 comment-section">
          {{plan.comment}}
        </div>
        <div class="col-sm-1">
          <button class="btn btn-xs btn-danger delete-button">
          X
          </button>
        </div>
      </div>
    </a>
  </div>
</div>

7. 用服务管理咱们的数据

创建计划类
在app下创建bean目录，做为咱们存放基本数据类的地方，而后创建plan.js,以下所示
在app下新建service目录，用于存放咱们的服务，而后进入该目录运行ng g service plan建立服务，以下所示：
修改刚刚建立的服务的ts文件以下：

import { Injectable } from '@angular/core';
import { Plan } from '../bean/plan';
@Injectable()
export class PlanService {
  plans: Plan[];
  constructor() {
    this.plans = [
    {
      id: 11,
      name: '大熊',
      date: 100000,
      totalTime: 1,
      comment: '学习到天亮'
    },
    {
      id: 22,
      name: '大熊',
      date: 100000,
      totalTime: 1,
      comment: '学习到天亮'
    },
    {
      id: 33,
      name: '大熊',
      date: 100000,
      totalTime: 1,
      comment: '学习到天亮'
    }];
   }
   getPlans() {
    return this.plans;
   }
  addPlan(newplan: Plan) {
    this.plans.push(newplan);
  }
  deletePlan(id: number) {
    let index = 0;
    for (let i = 0; i < this.plans.length; i++) {
      if (this.plans[i].id === id) {
        index = i;
        break;
      }
    }
    this.plans.splice(index, 1);
  }
  getPlan(id: number) {
    for (let i = 0; i < this.plans.length; i++) {
      if (this.plans[i].id === id) {
        return this.plans[i];
      }
    }
  }
}

在app.module.ts中加入服务依赖
import进建立的服务，并加入到providers中，以下：

import { PlanService } from './service/plan.service';

providers: [PlanService],

在plan-list中注入服务并使用

import { Component, OnInit } from '@angular/core';
import { PlanService } from '../service/plan.service';
import { Plan } from '../bean/plan';
@Component({
  selector: 'app-plan-list',
  templateUrl: './plan-list.component.html',
  styleUrls: ['./plan-list.component.css']
})
export class PlanListComponent implements OnInit {
  plans: Plan[];

  constructor(private planService: PlanService) { }

  ngOnInit() {
    this.plans = this.planService.getPlans();
  }

}

能够看到，我将原来写死在这个组件的plans去掉了，而是去调用了一个服务获取我所须要的数据。至此，你所看到的效果与原来的无异，可是咱们的项目又向前买进了一大步。

8. 删除计划

下面看一下如何删除一个计划，这里主要用到的是事件的绑定。

首先定义删除事件处理函数。在/src/app/plan-list/plan-list.component.ts添加以下事件处理函数

// 删除计划
  deletePlan (plan) {
    this.planService.deletePlan(plan.id);
    this.plans = this.planService.getPlans();
  }

在模板中绑定这个事件处理函数
这样你能够点击叉叉删除计划了

9. 建立一个管道来格式化咱们的日期

一样的数据在前端的显示可能要求不一样，这时须要咱们对数据进行一些格式化，管道这种东西是你的首选。

按以下操做建立初始化管道

观察文件变化和app.module的变化

修改咱们的/home/yibingxiong/ng-plan/src/app/pipe/data-format.pipe.ts以下

import { Pipe, PipeTransform } from '@angular/core';

@Pipe({
  name: 'dataFormat'
})
export class DataFormatPipe implements PipeTransform {

  transform(value: number): String {
    const d = new Date();
    d.setTime(value);
    const year = d.getFullYear();
    const month = d.getMonth() + 1;
    const date = d.getDate();
    const h = d.getHours();
    const m = d.getMinutes();
    const s = d.getSeconds();
    return (year + '-' + (month < 10 ? ('0' + month) : month) + '-' +
    (date < 10 ? ('0' + date) : date) + ' ' + (h < 10 ? ('0' + h) : h) +
    ':' + (m < 10 ? ('0' + m) : m) + ':' +
    (s < 10 ? ('0' + s) : s));
  }

}

使用咱们的管道，如图所示

10. 为咱们的planservice添加一个计算老是长的方法

在app.component中使用

可是会法现一个问题，当删除计划时总时长没有响应变化，下面设法解决这个问题。

11. 用service作一个共享的数据状态

通过一番坚苦卓绝的寻找，我终于在https://scotch.io/tutorials/get-angular-1-features-in-angular-2#toc-global-communication-with-services 找到了一个比较简单的解决方法，虽然我也不是太理解这个方法，不过能用。下面将我作的修改的文件列出来供你参考。此问题的解决还能够用一个些数据状态库。

// /home/yibingxiong/ng-plan/src/app/service/plan.service.ts
import { Injectable } from '@angular/core';
import { Plan } from '../bean/plan';
import { BehaviorSubject } from 'rxjs/BehaviorSubject';
@Injectable()
export class PlanService {
  plans: Plan[];
  totalTime = 0;
  totalTime$ = new BehaviorSubject<number>(this.totalTime);
  constructor() {
    this.plans = [
    {
      id: 11,
      name: '大熊',
      date: 100000,
      totalTime: 1,
      comment: '学习到天亮'
    },
    {
      id: 22,
      name: '大熊',
      date: 100000,
      totalTime: 1,
      comment: '学习到天亮'
    },
    {
      id: 33,
      name: '大熊',
      date: 100000,
      totalTime: 1,
      comment: '学习到天亮'
    }];
    this.totalTime = this.getTotalTime2();
   }
  getPlans() {
   return this.plans;
  }
  // 添加计划
  addPlan(newplan: Plan) {
    this.totalTime = this.getTotalTime2();
    this.updateTotalTimeSbj(this.totalTime);
    this.plans.push(newplan);
  }
  // 删除计划
  deletePlan(id: number) {
    let index = 0;
    for (let i = 0; i < this.plans.length; i++) {
      if (this.plans[i].id === id) {
        index = i;
        break;
      }
    }
    this.plans.splice(index, 1);
    this.totalTime = this.getTotalTime2();
    this.updateTotalTimeSbj(this.totalTime);
  }
  // 得到一个计划
  getPlan(id: number) {
    for (let i = 0; i < this.plans.length; i++) {
      if (this.plans[i].id === id) {
        return this.plans[i];
      }
    }
  }
  // 计算计划总时间
  getTotalTime2() {
    let t = 0;
    for (const p of this.plans) {
      t += p.totalTime;
    }
    return t;
  }
  get getTotalTime(): number {
    return this.totalTime;
  }
  private updateTotalTimeSbj(value) {
    this.totalTime$.next(value);
  }
}

// /home/yibingxiong/ng-plan/src/app/app.component.ts
import { Component } from '@angular/core';
import { PlanService } from './service/plan.service';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {
  constructor(private planService: PlanService) {

  }
  title = 'app';
}

// /home/yibingxiong/ng-plan/src/app/app.component.html
<app-navigation></app-navigation>
<div class="container">
  <div class="col-sm-3">
    <div class="panel panel-default">
      <div class="panel-heading">
        <h1 class="text-center">已有时长</h1>
      </div>
      <div class="panel-body">
        <h1 class="text-center">{{planService.getTotalTime}} 小时</h1>
      </div>
    </div>
  </div>
  <div class="col-sm-9">
    <router-outlet></router-outlet>
  </div>
</div>

12. 添加计划

老规矩，先建立页面组件

添加到路由
- 在/home/yibingxiong/ng-plan/src/app/app.module.ts的路由添加
```
{ path: 'create', component: CreateComponent },
```
- 修改/home/yibingxiong/ng-plan/src/app/home/home.component.html
```
<a routerLink="/create">建立一个任务</a>
```
完善添加计划页面
修改/home/yibingxiong/ng-plan/src/app/create/create.component.html

<div class="form-horizontal">
  <div class="form-group">
    <div class="col-sm-6">
      <label>日期</label>
      <input
        type="date"
        class="form-control"
        placeholder="Date"
      />
    </div>
    <div class="col-sm-6">
      <label>时间</label>
      <input
        type="number"
        class="form-control"
        placeholder="Hours"
      />
    </div>
  </div>
  <div class="form-group">
    <div class="col-sm-12">
      <label>备注</label>
      <input
        type="text"
        class="form-control"
        placeholder="Comment"
      />
    </div>
  </div>
  <button class="btn btn-primary">保存</button>
  <a class="btn btn-danger">取消</a>
  <hr>
</div>

作添加计划事件处理
- 建立事件处理函数

<div class="form-horizontal">
  <div class="form-group">
    <div class="col-sm-6">
      <label>日期</label>
      <input
        type="date"
        class="form-control"
        placeholder="Date"
        [(ngModel)]="newplan.date"
      />
    </div>
    <div class="col-sm-6">
      <label>时间</label>
      <input
        type="number"
        class="form-control"
        placeholder="Hours"
        [(ngModel)]="newplan.totalTime"
      />
    </div>
  </div>
  <div class="form-group">
    <div class="col-sm-12">
      <label>备注</label>
      <input
        type="text"
        class="form-control"
        placeholder="Comment"
        [(ngModel)]="newplan.comment"
      />
    </div>
  </div>
  <button class="btn btn-primary" (click)="addPlan(newplan)">保存</button>
  <a class="btn btn-danger">取消</a>
  <hr>
</div>

更新模板

<div class="form-horizontal">
  <div class="form-group">
    <div class="col-sm-6">
      <label>日期</label>
      <input
        type="date"
        class="form-control"
        placeholder="Date"
        [(ngModel)]="newplan.date"
      />
    </div>
    <div class="col-sm-6">
      <label>时间</label>
      <input
        type="number"
        class="form-control"
        placeholder="Hours"
        [(ngModel)]="newplan.totalTime"
      />
    </div>
  </div>
  <div class="form-group">
    <div class="col-sm-12">
      <label>备注</label>
      <input
        type="text"
        class="form-control"
        placeholder="Comment"
        [(ngModel)]="newplan.comment"
      />
    </div>
  </div>
  <button class="btn btn-primary" (click)="addPlan(newplan)">保存</button>
  <a class="btn btn-danger">取消</a>
  <hr>
</div>

取消返回处理
添加location依赖

在create组件注入并使用

在模板添加事件

<a class="btn btn-danger" (click)="cancel()">取消</a>

13. 去掉假数据，并添加无数据支持

修改planService，移除假数据

在planlist中加入无数据判断

总结一下

本文是我学习angular4两个晚上作的一个小Demo，我是一边作项目一边写的这个文档，因此按照个人文档操做通常能够顺利完成项目，可是不免有一些疏漏，请自行查找问题所在。
本项目虽小，可是他将angular的一些和性要点都用到了。

数据单向绑定
数据双向绑定
事件
依赖注入
组件
服务
管道
路由
模板指令
命令行用法

本项目的结构仅供参考，你能够搭建更加清晰的项目结构。例如将页面组件都放到page目录，将一些碎片化的组件放到components目录，这都是能够的，你能够灵活运用。很是感谢你能如此耐性的看到这里，但愿本文能对你有所帮助。最后，要是你以为这篇文章还不错，请在个人博客http://www.cnblogs.com/floor/ 点个关注，或者点个推荐。或者帮忙点一下star，github地址：https://github.com/yibingxiong/ng-plan