Day 25｜延遲載入：@defer

2025 iThome 鐵人賽

DAY 25

Modern Web

Angular：踏上現代英雄之旅系列第 25 篇

17th鐵人賽

阿蘇

2025-10-09 23:17:01

53 瀏覽

分享至

哈囉，各位邦友們！
今天的主角是 Angular v17 引入的「可延遲視圖」：@defer。
它能讓你把「非關鍵、可晚點出現」的區塊推遲載入，改善初始載入與互動速度。
我們會用實戰範例示範「何時載、怎麼載、出錯怎麼辦」。

今天要做什麼？

認識 @defer 與可用的觸發條件。
實作 on viewport 與 on interaction 的典型情境。
加上 @placeholder、@loading、@error 與 prefetch。
蒐集最佳實務與常見地雷，建立你的延遲載入口袋名單。

前置需求

熟悉 Standalone 與控制流。
專案可 ng serve，具備 LoadingSpinner、MessageBanner 等共用元件（Day15、Day17）。

一、什麼是 `@defer`？

一句話：把不需要「立刻」出現的畫面延後載入。
@defer 區塊會等到特定條件達成時才載入其內容（含依賴的元件／模組），
在此之前可以顯示 @placeholder 骨架、載入中狀態 @loading，或在錯誤時顯示 @error 區塊。

常見觸發條件：

on viewport：區塊進入可視區時載入（常用於頁面下方區塊）
on interaction(target)：使用者互動後載入（點擊、focus、input…）
on hover(target)：滑過目標後載入
on idle：瀏覽器閒置時載入（不影響關鍵互動）
on timer(ms)：延遲指定時間後載入
when expr：當條件為真時載入（可搭配 signal/表單/路由）

可搭配 prefetch：

prefetch on idle / on viewport / on interaction(...)：先行抓資源但不渲染，
真正需要時能秒開，視覺更流暢。

二、在 `Dashboard` 頁面下方元件用 `on viewport` 延遲

在 Dashboard 下方新增一個TopHeroesChart元件，
讓它進入視窗才載入；在此之前顯示骨架或 Loading。

ng g c top-heroes-chart

// src/app/top-heroes-chart/top-heroes-chart.ts
import { Component } from '@angular/core';

@Component({
  selector: 'app-top-heroes-chart',
  imports: [],
  templateUrl: './top-heroes-chart.html',
  styleUrl: './top-heroes-chart.scss'
})
export class TopHeroesChart {

}

<!-- src/app/top-heroes-chart/top-heroes-chart.html -->
<section class="chart">
  <h3>Top Heroes</h3>
  <!-- 這裡可放實際圖表或列表 -->
  <ul>
    <li>Hero A</li>
    <li>Hero B</li>
    <li>Hero C</li>
  </ul>
</section>

// src/app/dashboard/dashboard.component.ts
import { Component } from '@angular/core';
import { TopHeroesChart } from '../top-heroes-chart/top-heroes-chart';
import { LoadingSpinner } from '../ui/loading-spinner/loading-spinner';
import { MessageBanner } from '../ui/message-banner/message-banner';

@Component({
  selector: 'app-dashboard',
  imports: [TopHeroesChart, LoadingSpinner, MessageBanner],
  templateUrl: './dashboard.component.html',
  styleUrl: './dashboard.component.scss',
})
export class DashboardComponent {}

<!-- src/app/dashboard/dashboard.component.html -->
<section class="dashboard">
  <h2>Dashboard</h2>
  <p class="muted">以下排行榜為次要內容，進入視窗再載入。</p>

  @defer (on viewport; prefetch on idle) {
    <app-top-heroes-chart />
  } @placeholder (minimum 300ms) {
    <div class="skeleton skeleton--chart" aria-hidden="true"></div>
  } @loading (after 100ms; minimum 400ms) {
    <app-loading-spinner label="載入排行榜..." />
  } @error {
    <app-message-banner type="error">排行榜載入失敗，稍後再試。</app-message-banner>
  }
</section>

/* src/app/dashboard/dashboard.component.scss */
.skeleton--chart {
  height: 260px;
  border-radius: 12px;
  background: linear-gradient(
    90deg,
    #eef1f7 25%,
    #f6f8fc 37%,
    #eef1f7 63%
  );
  background-size: 400% 100%;
  animation: shimmer 1.25s ease-in-out infinite;
}

@keyframes shimmer {
  0% { background-position: 100% 0; }
  100% { background-position: 0 0; }
}

說明：