angular6的table组件开发的实现示例

时间:2020-05-16 DragonChen 人气:0

背景及吐槽：

今年有机会再次接触angualr这个框架，想起第一次接触ng还是16年读书的时候，当时还是ng1，然后学起来特别辛苦，学习曲线特别陡峭；而今年有一个项目重构直接采用了angular6，而后面该项目后面由我负责开发和维护，然后我又重新再学习了ng6，本以为有ng1的基础，学起来会好一些，然并卵，学习的曲线特别陡峭，但还是最后将ng6啃下来（很不情愿去学的，但没办法）。回归到项目，该项目没有引入其他组件库，所以很多基础组件都是自己开发（用ng开发那种酸爽很带劲），其中table组件让我思考了差不多两个星期，最后才开发出来，吐槽完毕，接下来就介绍一下我的做法，我的做法不一定最正确。

形式：

主要参考element里面的table组的格式：

vue:

<el-table :data="tableData">
  <el-table-column prop="date" label="日期"></el-table-column>
  <el-table-column label="操作">
   <template slot-scope="scope">
    <el-button @click="handleClick(scope.row)" type="text" size="small">查看</el-button>
   </template>
  </el-table-column>
 </el-table>

所以得到了angualr的table组件的格式：

<app-widget-table [data]="tableData">
  <app-widget-table-column prop="date" label="日期"></app-widget-table-column>

  <app-widget-table-column label="操作">
   <ng-template #scope let-row="scope">
      <ng-widget-button (click)="handleClick(row)" type="text" size="small">查看</el-button>
   </ng-template>
  </app-widget-table-column>
</app-widget-table>

在angular的table组件中，最为困难就是ng-template如何将作用域绑定到ng-widget-button组件中；

关键点知识讲解：

ng-content：
可以将父组件中所包含的所有子组件，都插入table组件中ng-container所在的位置，跟vue中的slot很像；

ng-container:
可以作为一个组件的模板，跟vue里面的template组件很像；

ng-template：
该东西，是整个组件中最为麻烦的一个东西，直接使用它，会没有任何效果，必须要和TemplateRef和ngTemplateOutlet一起使用，才有有效果，主要是作为模板并引入作用域，具体原理可以看一下官方文档（https://www.angular.cn/api）

TemplateRef：
主要是用来获取ng-template组件的引用；

ngTemplateOutlet：
将ng-template的内容在html页面展示出来，并绑定变量，就像vue中的router-view；

QueryList：
获取table组件中所有的内容指引；

ContentChildren：
内容映射的接口，针对多个子元素采用

ContentChild：
内容映射的接口，针对单个子元素采用

先对app-widget-table-column组件进行分析：
该组件的作用就是为了运输数据，并且引入内容，该组件本身是不会有任何操作和逻辑，就是一个运输工；

table-column.component.html：

<ng-container></ng-container>

table-column.component.ts：

import {Component, Input, Output, TemplateRef, ContentChild, AfterContentInit} from '@angular/core';

@Component({
  selector: 'app-widget-table-column',
  templateUrl: './table-column.component.html',
  styleUrls: ['./table-column.component.less'],
  preserveWhitespaces: false
})
export class TableColumnComponent implements AfterContentInit {
  constructor() {

  }

  @Input()
  label: string;

  @Input()
  prop: string;

  @Input()
  class: string;

  @Input()
  style: object;

  @ContentChild('scope') // 获取ng-template组件的一个本地变量，并修饰scope对象
  scope: TemplateRef<any>; // 获取ng-template的指引，主要是其内容，any表示该指可以是任何内容

  ngAfterContentInit(): void {}
}

table.component.html

<div>
  <div>
    <ng-content></ng-content> // 主要是用来引入整个table组件的内容，但不会在页面显示任何内容
  </div>

  <table class="table">
    <thead>
    <tr>
     <th *ngFor="let label of labelList">{{label}}</th>  // 类似于v-for，主要讲table-cloumn的所有label搜集，并展示
    </tr>
    </thead>

    <tbody *ngIf="data.length > 0">
    <ng-container *ngFor="let item of data; let i = index">
      <tr>
        <ng-container *ngFor="let row of tableColumn['_results']">
          <td *ngIf="row.prop" [ngStyle]="row.style" [ngClass]="row.class">{{item[row.prop]}}</td> // 直接展示

          <td *ngIf="row.scope" [ngStyle]="row.style" [ngClass]="row.class">
            <ng-container *ngTemplateOutlet="row.scope; context: {$implicit: {}, scope: data[i]}">
            </ng-container> // 展示ng-template的内容
          </td>
        </ng-container>
      </tr>
    </ng-container>
    </tbody>
  </table>

  <div *ngIf="data.length === 0" class="none-data">暂无数据!</div>
</div>

table.component.ts:

import {Component, OnInit, Input, Output, ContentChildren, AfterContentInit, ViewChild, AfterViewInit, QueryList} from '@angular/core';
import {TableColumnComponent} from '../table-column/table-column.component';

@Component({
  selector: 'app-widget-table',
  templateUrl: './table.component.html',
  styleUrls: ['./table.component.less'],
  preserveWhitespaces: false
})
export class TableComponent implements OnInit, AfterContentInit {
  constructor() {

  }

  @ContentChildren(TableColumnComponent)
  tableColumn: QueryList<TableColumnComponent>; // 获取table-cloumn组件的所有实例

  @Input()
  data: object[];

  labelList: string[] = [];

  ngOnInit(): void {
    if (!(this.data instanceof Array)) {
      throw new Error('the data into TableComonent must be Array!');
    }
  }

  ngAfterContentInit(): void {
    this.labelList = this.tableColumn['_results'].map(item => item.label);
  }
}

虽然看起来这两个组件的代码不多，但里面的逻辑却比较绕，这也证明了ng用起来十分难上手，不过真的称赞的是，ng采用ts和rx，用上手确实是比较爽。

这两个组件目前还是比较粗糙，功能和特性也不是特别多，只能满足一般表格的需求，后续会继续完善该组件以及其他项目中用ng来开发的基础组件，希望能沉淀出一套ng的组件库。

加载全部内容