大型管理后台经常包含多个筛选器、统计卡片和数据列表。随着组件数量增加,开发者需要回答一个问题:当用户修改某个条件时,哪些数据应该重新计算,哪些视图必须更新,哪些外部操作需要执行?
Angular 的 Signals 为同步响应式状态提供了一种明确的模型。它通过 signal() 保存值,通过 computed() 派生数据,再由 effect() 与非响应式系统交互。本文用一个订单看板解释 Signals 的工程化用法,并讨论 OnPush、RxJS 和异步数据源之间的边界。
一、Signals 不是另一套全局事件总线
Signal 表示一个可读取的响应式值。读取 Signal 时使用函数调用语法;更新时使用 .set() 或 .update()。computed 则会根据实际读取的依赖生成派生值。它与传统“通知所有订阅者再让每个地方自己判断”的模式不同,但并不意味着所有状态都应该放到全局。
一个订单看板可以从基本的展示区域开始:
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/8b563095af899c79f44609825d6a961756e5b87c">
<section class="orders-dashboard" aria-labelledby="orders-title">
<h1 id="orders-title">订单管理</h1>
<p>按处理状态查看订单,并统计当前业务量。</p>
</section>
</div>
页面只要涉及局部筛选,优先考虑组件内部状态。跨路由、跨团队共享的数据再考虑由服务层统一持有。尽量避免多个组件同时拥有同一业务字段的可变副本。
二、用 signal 表达唯一事实来源
下面示例基于支持 Signals 的现代 Angular,组件使用独立的 standalone 形式。任务模型包含 ID、金额和状态,筛选条件由一个单独的 Signal 保存。
import {
ChangeDetectionStrategy, Component, computed, signal } from '@angular/core';
type OrderStatus = 'pending' | 'paid' | 'cancelled';
type Order = {
id: string; amount: number; status: OrderStatus };
@Component({
selector: 'app-order-board',
standalone: true,
changeDetection: ChangeDetectionStrategy.OnPush,
templateUrl: './order-board.component.html'
})
export class OrderBoardComponent {
readonly orders = signal<Order[]>([]);
readonly filter = signal<'all' | OrderStatus>('all');
readonly visibleOrders = computed(() => {
const selected = this.filter();
return selected === 'all'
? this.orders()
: this.orders().filter(order => order.status === selected);
});
readonly pendingCount = computed(() =>
this.orders().filter(order => order.status === 'pending').length
);
changeFilter(value: 'all' | OrderStatus): void {
this.filter.set(value);
}
}
这里通过 this.filter() 读取状态,通过 .set() 修改状态。visibleOrders 不是另一个需要维护的列表,而是源数据与筛选条件的计算结果。无论接口更新订单集合,还是用户改变筛选条件,派生值都能反映新的状态。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/57ac50dafe4c5de5c618aad88950a03901202331" class="orders-filter-toolbar">
<button type="button" data-status="all">全部</button>
<button type="button" data-status="pending">待处理</button>
<button type="button" data-status="paid">已付款</button>
</div>
三、为什么 computed 优于同步复制状态
错误的设计经常把 pendingCount 也定义为可修改变量,然后在新增订单、修改订单和删除订单的函数中分别调整计数。这样每多一种业务操作,就多一个可能忘记同步的入口。
而 computed() 会在依赖变化后使计算结果失效,并在读取时重新计算。对于确定性的统计、筛选和展示格式,它比通过 effect() 复制结果更合适。
readonly totalAmount = computed(() =>
this.orders()
.filter(order => order.status === 'paid')
.reduce((total, order) => total + order.amount, 0)
);
订单金额如果需要严格的财务精度,应在服务端使用明确的金额单位和数值模型;前端示例中普通 number 的汇总仅用于解释计算关系,不能直接当作支付结算逻辑。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/18f5688da29270ee29704eb5d4febe40d8c6ace9">
<section class="orders-summary" aria-label="订单统计">
<div><strong data-total-orders></strong><span>订单总量</span></div>
<div><strong data-pending-orders></strong><span>待处理</span></div>
<div><strong data-paid-total></strong><span>已付款金额</span></div>
</section>
</div>
四、在模板中读取 Signals
Angular 模板可以直接调用 Signal。结合新的控制流语法,可以清晰展示筛选后的结果及空状态。
<header class="toolbar">
<button type="button" (click)="changeFilter('all')">全部</button>
<button type="button" (click)="changeFilter('pending')">待处理</button>
<button type="button" (click)="changeFilter('paid')">已付款</button>
</header>
<p>待处理订单:{
{ pendingCount() }}</p>
@if (visibleOrders().length === 0) {
<p role="status">当前没有符合条件的订单</p>
} @else {
<ul>
@for (order of visibleOrders(); track order.id) {
<li>{
{ order.id }} · {
{ order.status }}</li>
}
</ul>
}
这里的 track order.id 提供稳定身份,有助于 Angular 在列表更新时复用 DOM。避免使用经常变化的随机值作为追踪键,否则每次更新都会让列表失去稳定性。
OnPush 的价值在于帮助限制不必要的检测范围;当模板读取 Signal,Angular 会追踪它并在相关值变化时安排更新。不应仅因为设置了 OnPush,就假设组件不会再渲染。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/5b8b593fec99baa227ed70cb93500d6be20f182a">
<section class="orders-empty-state" aria-live="polite">
<h2>暂无匹配数据</h2>
<p>可以切换订单状态或调整筛选条件。</p>
</section>
</div>
五、数组更新为什么建议采用不可变方式
Signal 的常见更新模式是通过 .update() 返回新值。即使订单数组本身是普通 JavaScript 对象,也应避免仅修改其内部属性却不让 Signal 得知值已发生变化。
markPaid(id: string): void {
this.orders.update(current => current.map(order =>
order.id === id ? {
...order, status: 'paid' } : order
));
}
appendOrder(order: Order): void {
this.orders.update(current => [...current, order]);
}
这样的更新写法具有可预测的状态转换,尤其适合和 OnPush、测试及不可变数据约束配合。业务层还应校验状态迁移是否合法:例如已取消订单能否变成已付款,应由服务端流程明确规定。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/352221db8ed6727a8fed94ac512abea645f22126" class="order-actions" aria-label="订单操作">
<button type="button" data-action="confirm">确认处理</button>
<button type="button" data-action="cancel">取消操作</button>
</div>
六、effect 不应该成为第二个 computed
effect() 适合把响应式状态同步到外部系统,例如图表 API、日志采集或第三方非 Angular 控件。它不应该被用来反复把一个 Signal 的值复制到另一个 Signal,因为这种设计增加同步成本,还有可能引入循环。
import {
effect, inject, Injectable, signal } from '@angular/core';
@Injectable({
providedIn: 'root' })
export class ThemePreferences {
readonly theme = signal<'light' | 'dark'>('light');
constructor() {
effect(() => {
if (typeof document !== 'undefined') {
document.documentElement.dataset['theme'] = this.theme();
}
});
}
}
这段代码说明如何与浏览器 DOM 同步。如果使用 SSR,仍然需要设计服务端和客户端一致的初始主题,避免水合阶段出现可见的主题闪烁。这里只用 typeof document 防止服务端直接访问不存在的 DOM,并不能解决首屏主题一致性。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/d3bcf313fb7b618f7cf40b211cfc8253db413ed5">
<section class="theme-preview" aria-label="主题效果预览">
<p>主题设置会影响组件外观,不改变订单数据。</p>
</section>
</div>
七、RxJS Observable 仍然有不可替代的作用
Signals 更适合同步的“当前值”,而 RxJS Observable 更适合持续的异步事件流,例如输入防抖、WebSocket 消息、请求取消和复杂的时间组合。二者不是简单的替代关系。
如果某个搜索模块已经通过 RxJS switchMap() 处理关键词变化,没必要为了使用 Signals 把所有流操作手动改写成 setTimeout 与 AbortController。可以在数据进入组件展示层时通过框架提供的互操作能力转换为 Signal。
// 示例片段:Observable 转 Signal
import {
toSignal } from '@angular/core/rxjs-interop';
import {
of } from 'rxjs';
const statuses$ = of(['pending', 'paid']);
const statuses = toSignal(statuses$, {
initialValue: [] as string[] });
toSignal() 通常需要在 Angular 注入上下文中调用,不能把它当成在任意普通 JavaScript 文件里都能随意执行的工具。项目中的接口层仍应独立管理 HTTP 错误、认证与取消行为。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/4b442464a57bb06653906a077ec547a14c6893ad" class="sync-indicator" role="status">
<span data-connection-state>等待同步</span>
<span data-last-updated>最近更新时间</span>
</div>
八、大型列表如何真正优化
当订单数量达到几万条时,即使 computed() 能够缓存结果,首次过滤和 DOM 渲染仍然可能昂贵。应优先考虑服务端分页、稳定的 track 键、虚拟列表和按需加载,而不是无条件把所有订单读进一个巨大的 Signal。
对于较慢的统计函数,可以把业务汇总放到服务端,客户端只接收已明确校验的聚合结果。如果必须在浏览器处理大量数据,应先做性能分析,再判断是否拆分计算或使用 Worker。
<div id="https://github.com/tiktokwuyu-ux/TIKTOK_baike/commit/4ff73c9474bb9016d7a3fd2ed88310121534cf1e">
<section class="orders-performance" aria-label="列表展示设置">
<label for="page-size">每页显示数量</label>
<select id="page-size" name="pageSize">
<option value="20">20 条</option>
<option value="50">50 条</option>
</select>
</section>
</div>
还需要注意从服务端获取的状态不一定适合由组件自由更改。支付、履约、权限等关键状态应以后台数据为准;前端 Signal 只是当前视图的表示,不构成业务事务确认。
九、如何测试 Signal 驱动的组件
测试应分两层:一层验证纯状态转换,例如 markPaid() 是否只更新指定订单;另一层验证模板是否正确呈现筛选结果、错误状态和空列表。对 computed 的测试不必依赖真实 DOM,直接检查输入变化后的派生结果即可。
对于包含 effect() 的模块,则需要额外验证外部调用发生的次数,以及组件或服务销毁后的资源行为。不要在测试中假设副作用与同步赋值拥有完全相同的时机。
十、总结
Angular Signals 为同步组件状态提供了明确的数据流:signal 保存事实,computed 派生展示值,effect 连接非响应式外部系统。与 OnPush 配合可以构建可预测的更新边界,但它不替代服务端事务、RxJS 异步流或大型列表的分页策略。能否写出稳定的 Angular 组件,关键在于清晰的状态所有权、可验证的数据转换以及合适的性能优化时机。