Angular进阶之六：Progressive rendering

简介

Progressive Rendering 是一种提高 Web 应用性能的方法，允许页面在加载过程中逐步呈现，以提高用户体验。在本文中，我们将探讨如何在 Angular 中通过自定义指令实现 Progressive Rendering，特别是处理从服务器获取大量数据的场景。

目标

通过自定义指令将数据加载设计为异步操作，并在数据加载的同时允许页面逐步渲染，以提高用户对应用的感知。

步骤

1. 创建数据服务

首先，创建一个数据服务（例如 data.service.ts），用于模拟从服务器获取大量数据的异步操作。

// data.service.ts

import { Injectable } from '@angular/core';
import { Observable, of } from 'rxjs';

@Injectable({
  providedIn: 'root'
})
export class DataService {
  getData(): Observable<string[]> {
    // 模拟从服务器获取大量数据
    return of(Array.from({ length: 1000 }, (_, i) => `Item ${i + 1}`));
  }
}

2. 创建自定义指令

创建一个自定义指令，通过@Directive 装饰器来标记，并包含一些属性和方法，结合依赖注入、生命周期钩子、渲染引擎等机制，实现对DOM元素的控制和增强。指令在模板中通过选择器标识，并通过属性绑定和输入属性传递数据，使得开发者能够轻松扩展和定制Angular应用的行为。

例如 ProgressiveRenderingDirective，该指令将异步加载数据并在数据加载的同时逐步渲染页面。

// progressiveRendering.directive.ts

import { Directive, Input, TemplateRef, ViewContainerRef } from '@angular/core';

@Directive({
    // selector 属性定义了在模板中如何标识和使用这个指令。例如，'*progressiveRendering' 表示这个指令可以通过属性选择器在元素上使用。                                                  
  selector: '[progressiveRendering]' 
})
export class ProgressiveRenderingDirective {

  constructor(
    // 用于表示指令所在元素的模板。指令所在元素的模板结构。通过TemplateRef，我们可以访问到包含在这个元素中的内容。
    private templateRef: TemplateRef<any>, 
     // 用于表示指令所在元素的视图容器。这个容器可以包含一个或多个视图，并允许动态地添加、移除这些视图。
    private viewContainer: ViewContainerRef 
  ) {}
    loading = true;
    dataSource: any = [];
  @Input() set progressiveRenderingLoading(loading: boolean) {
    this.loading = loading;
  }

  @Input()   //@Input 装饰器定义输入属性，这样在模板中就可以通过属性绑定来传递值。
    set progressiveRenderingOf(list: any[]) {  // 指令中定义与属性名相对应的 setter 方法，该方法会被调用。这个 setter 方法可以包含额外的逻辑，以响应属性值的变化。
        this.dataSource = list;
        if (this.loading) {
            this.viewContainer.clear();
            this.loadAsyncData();
          } else {
            this.viewContainer.createEmbeddedView(this.templateRef);
          }
    }

  private loadAsyncData() {
      // 异步加载数据
      this.dataSource.forEach((value: any, index: any) => {
        setTimeout(() => {
            this.viewContainer.createEmbeddedView(this.templateRef, { $implicit: value, index: index })
        }, index * 100)
      });
  }
}

3. 在组件中使用指令

在你的 Angular 组件中使用刚刚创建的指令来实现 Progressive Rendering。

<!-- app.component.html -->
<!--  简化前
<ng-template progressiveRendering let-value [progressiveRenderingOf]="asyncData"
  let-i="index">
  <div>
     {{ value }}
  </div>
</ng-template>
-->
<!-- * 也被称为结构指令，是一种将结构指令应用于元素的简写语法。它允许简化语法并使其更具可读性。-->
<div *progressiveRendering="let value of asyncData; loading">
    {{ value }}
    </div>

// app.component.ts

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

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.less']
})
export class AppComponent implements OnInit {
  constructor(private dataService: DataService) {}
  asyncData: string[] = [];
  loading = true;

  ngOnInit(): void {
    this.dataService.getData().subscribe((data: string[]) => {
      this.asyncData = data;
      this.loading = false;
    });
  }