复杂 Angular 后台经常在一个页面里同时展示统计数字、趋势图、审计记录和高级筛选器。但并不是所有模块都必须在首屏立即下载并初始化。例如,位于页面底部的趋势分析图可能很重,而用户只想查看顶部的订单汇总。
Angular 提供的 @defer 模板语法能够把符合条件的依赖拆分为延迟加载代码,并通过触发器决定何时展示。本文以数据监控页面为例,讲解 @defer、@placeholder、@loading、@error 及预取策略,同时说明代码拆分的真实限制。
一、先识别哪些组件值得延迟加载
首屏导航、主要表单、关键业务提示等应保证优先可用;复杂图表、导出面板和历史记录可以评估延迟加载。判断依据应是用户操作路径和模块的实际成本,而不是简单地把所有内容都放进 @defer。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/d2a9a583cb514aceb15513964ab356ef0cd25b4c" class="monitoring-dashboard">
<header><h1>运行监控</h1><p>查看核心指标与详细趋势</p></header>
<section data-summary-cards aria-label="关键指标"></section>
<section data-trend-chart aria-label="趋势分析"></section>
</div>
如果把用户立即需要的模块延迟到视口滚动后才加载,反而可能增加等待与布局跳动。因此应先用构建产物分析和浏览器性能工具找出重模块。
二、最基础的 @defer 结构
假设 HeavyChartComponent 是独立组件(standalone component),在宿主组件的模板中可以这样声明:
<!-- dashboard.component.html 中的 Angular 模板 -->
@defer {
<app-heavy-chart />
} @placeholder {
<p>趋势图尚未加载</p>
}
未指定触发器时,默认可以在浏览器空闲时触发延迟加载。@placeholder 在触发前提供占位内容;触发后 Angular 加载所需依赖并渲染目标组件。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/abc6f81bc24d9553ee7b6cb2827e656c7ba2f454" class="chart-placeholder" aria-live="polite">
<h3>趋势分析</h3>
<p data-chart-hint>图表将在需要时加载</p>
</div>
需要注意,并非放进 @defer 的任何依赖都会自动拆成独立包。可延迟的组件、指令和管道需满足编译器的依赖条件;尤其要避免在延迟块之外同步引用同一个组件,从而导致它被提前加载。
三、根据视口触发加载
长页面中位于下方的图表,适合采用 on viewport。浏览器观察占位元素何时进入视口附近,再加载真正的组件。
@defer (on viewport) {
<app-heavy-chart />
} @placeholder {
<div class="chart-skeleton" aria-label="图表占位区域">
<p>向下滚动后展示趋势图</p>
</div>
} @loading {
<p role="status">正在准备趋势图…</p>
} @error {
<p role="alert">图表资源加载失败</p>
}
视口触发依赖一个可被观察的对象。以上占位元素具有单一根节点,便于 Angular 确定观察目标。滚动触发并不意味着组件会在用户离开视口时自动卸载;@defer 主要控制首次加载时机。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/afd8f8e320954d0fd4491121af66780758a1911b" class="viewport-trigger-demo">
<div data-visible-summary>当前视图指标</div>
<div data-chart-entry>下方为可延迟的图表区域</div>
</div>
四、交互触发与预取可以分开
对于高级设置窗口,用户可能从不打开它。使用 on interaction 可以在用户与占位元素交互时触发加载;再通过 prefetch on idle 利用空闲时间提前下载代码。
@defer (on interaction; prefetch on idle) {
<app-advanced-settings />
} @placeholder {
<button type="button">打开高级设置</button>
} @loading {
<p role="status">正在载入设置面板…</p>
} @error {
<p role="alert">设置面板载入失败</p>
}
预取和实际渲染是两件事:预取可以提前获取代码资源,但并不表示应该提前执行全部组件逻辑。预取也会消耗网络带宽,应结合用户访问路径和设备情况决定是否启用。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/e84f926517820b3ac368ca457d86cca27b13de95" class="advanced-settings-entry">
<button type="button" data-open-settings>高级设置</button>
<span data-prefetch-status>等待交互</span>
</div>
五、理解 placeholder、loading 和 error 的区别
@placeholder 表示尚未达到延迟触发条件;@loading 表示已经触发但依赖尚未加载完成;@error 表示延迟依赖加载失败。
可以通过 after 和 minimum 控制 loading 内容的出现和最短展示时间,避免非常快的网络请求导致提示闪烁。
@defer (on viewport) {
<app-activity-history />
} @placeholder (minimum 200ms) {
<p>历史操作记录将在滚动后展示</p>
} @loading (after 100ms; minimum 300ms) {
<p role="status">正在读取历史记录组件…</p>
} @error {
<p role="alert">历史记录组件加载失败</p>
}
这些时间控制的是展示状态,而不是业务接口的超时机制。组件加载完成后,如果内部 API 请求失败,还需要组件自己的数据错误提示,两者不应混为一谈。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/0d5167153f51a7124d7b685f840a32da00d23fb1" class="activity-history-status" aria-live="polite">
<p data-component-loading>组件准备中</p>
<p data-data-loading>数据尚未读取</p>
</div>
六、减少布局跳动与首屏竞争
如果占位区域只有一行文字,而真正的图表需要三百像素高度,渲染完成时页面布局可能突然改变。可以为占位区域设置合理的最小高度或纵横比。
.chart-skeleton {
min-height: 18rem;
border-radius: 0.75rem;
background: linear-gradient(90deg, #eef2f7, #e2e8f0, #eef2f7);
}
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/12ac96745fff62ec124e6a6e935596a37d13bd0b" class="chart-layout-reservation">
<div class="chart-skeleton" aria-hidden="true"></div>
<p class="sr-only">图表区域正在准备</p>
</div>
此外,如果多个嵌套的 @defer 使用相同的触发条件,可能在同一时刻集中下载大量依赖。应考虑将最重要的图表优先展示,次要面板采用交互触发,避免人为制造新的加载峰值。
七、@defer 与路由级懒加载的关系
路由级懒加载解决的是“尚未进入这个功能页面”;@defer 解决的是“已经进入页面,但某一部分组件暂时用不上”。两者可以配合使用。
例如,把管理后台的报表路由作为独立模块按需加载,在进入报表页后,再将复杂图表和导出面板分别延迟展示。这种拆分通常比仅通过 CSS 隐藏大组件更有效,因为隐藏 DOM 并不会自动阻止相应 JavaScript 被下载和执行。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/f5b78f247e24dc6bccf0ca41c994f5f432a888a8" class="report-workspace">
<nav aria-label="报表导航"></nav>
<section data-essential-report>基础报表</section>
<section data-optional-visualization>高级可视化</section>
</div>
如果组件依赖一个很大的共享包,实际构建时未必能得到理想的体积分割。因此必须查看构建后的 chunk 结构,不能仅凭模板里出现了 @defer 就宣布加载体积降低。
八、如何测试懒加载行为
开发环境下,网络通常很快,可能难以观察 placeholder 和 loading 状态。应该配合浏览器网络限速、Performance 面板以及框架测试工具,检查首次加载时是否真的避免下载不必要的组件依赖。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/be4a75af7cc51cc05f28c6ee06eaa39c1a52b5fb" class="defer-test-checklist">
<h3>延迟加载检查</h3>
<output data-test="initial">首屏 chunk 数量</output>
<output data-test="viewport">进入视口后的加载</output>
<output data-test="failure">资源失败的提示</output>
</div>
除了组件资源,还需要分别验证 API 请求数量、重试行为以及屏幕阅读器能否获得加载状态。延迟模块如果包含重要交互控件,应确保聚焦顺序和键盘操作不会被突然出现的内容打断。
九、总结
Angular 的 @defer 把组件首次加载的时间控制放进模板,配合视口、交互和预取触发器,可以减少用户暂时不需要的代码进入初始加载路径。但它不是自动性能优化按钮。只有选择合理的延迟边界、控制占位尺寸、验证实际 chunk 变化,并处理加载失败与无障碍交互,才能把代码拆分转化为稳定的使用体验。