如何同步 Angular signals 与 AG Grid rowData,避免丢失未保存修改?
建议将服务端快照与正在编辑的行草稿分开。如果其他 Angular 组件也需要读取当前行数据,可以用可写 signal 保存草稿,通过 readOnlyEdit 和 cellEditRequest 接收表格编辑,再将草稿绑定给 rowData。单据头变化时,不重新初始化行草稿。
如果行数据只在表格中使用,也可以由 AG Grid 管理草稿,保存时再读取行数据。无论采用哪种方式,都需要明确由谁保存当前编辑结果,以及外部更新何时可以覆盖这些结果。
为什么当前依赖链会覆盖修改?
linkedSignal(() => this.sortedLines()) 会根据依赖重新计算其值。即使此前通过 .set() 或 .update() 修改过它,依赖变化后仍可能重新生成值。它不会自动合并 AG Grid 内部的编辑、新增和删除操作。Angular linkedSignal 文档
表格编辑和事务更新的行为也有所不同:
- 默认单元格编辑通常直接修改传入的行对象。对象字段可能已经变化,但 Angular signal 不会因为对象内部被修改而自动发出更新。
applyTransaction会改变表格内部的行集合,不会自动维护绑定 signal 中的数组。AG Grid 值保存说明、Transaction Updates 文档
因此,signal 和表格可能共用部分对象,但没有共用完整、可追踪的编辑状态。
修改单据头也不一定会导致整条链传播。Angular signals 默认使用 Object.is() 比较值;如果 productNoteLines 仍返回同一个 lines 数组引用,下游不一定重新计算。需要检查更新过程中是否重新创建了 lines 数组,以及是否存在其他重置路径。只要 sortedLines 重新执行,其中的 map() 和 new GridRow(line) 就会生成新的数组和行对象。Angular signal 相等性说明
推荐方式:由 signal 保存行草稿
数据流可以这样安排:
完整记录加载 → 初始化行草稿
表格编辑请求 → 更新行草稿 → rowData
新增或删除操作 → 更新行草稿 → rowData
单据头修改 → 更新单据头状态
开启 readOnlyEdit 后,AG Grid 不再直接提交单元格值,而是发出 cellEditRequest,由应用处理更新,适合外部状态管理。AG Grid Read Only Edit 文档
下面的示例使用简化的 DraftRow,假设行具有稳定的字符串 id,可编辑字段 quantity 为数值类型。这些字段需要替换为实际模型。将状态和方法合并到现有组件,并沿用项目已有的组件配置与 AG Grid 模块注册。
import { signal } from '@angular/core';
import type {
CellEditRequestEvent,
ColDef,
GetRowIdParams,
GridApi,
} from 'ag-grid-community';
type DraftRow = {
id: string;
quantity: number;
};
type NoteSnapshot = {
id: string;
lines: DraftRow[];
};
export class NoteEditor {
readonly draftRows = signal<DraftRow[]>([]);
private activeRecordId: string | null = null;
readonly columnDefs: ColDef<DraftRow>[] = [
{ field: 'id', editable: false },
{
field: 'quantity',
editable: true,
cellEditor: 'agNumberCellEditor',
},
];
readonly getRowId = (params: GetRowIdParams<DraftRow>) =>
params.data.id;
// 在完整记录加载完成后调用。
// 切换前,先由页面流程处理旧记录的未保存修改。
openRecord(detail: NoteSnapshot): void {
if (detail.id === this.activeRecordId) return;
this.activeRecordId = detail.id;
this.draftRows.set(detail.lines.map(row => ({ ...row })));
}
onCellEditRequest(event: CellEditRequestEvent<DraftRow>): void {
if (!event.data || event.colDef.field !== 'quantity') return;
const quantity = event.newValue;
if (typeof quantity !== 'number' || !Number.isFinite(quantity)) {
return;
}
const id = event.data.id;
this.draftRows.update(rows =>
rows.map(row =>
row.id === id ? { ...row, quantity } : row
)
);
}
// 调用方应提供唯一且稳定的 id,包括尚未保存的新行。
addRow(row: DraftRow): void {
this.draftRows.update(rows => [...rows, { ...row }]);
}
removeRow(id: string): void {
this.draftRows.update(rows => rows.filter(row => row.id !== id));
}
collectRowsForSave(api: GridApi<DraftRow>): DraftRow[] {
api.stopEditing();
return this.draftRows().map(row => ({ ...row }));
}
}
模板绑定:
<ag-grid-angular
[columnDefs]="columnDefs"
[rowData]="draftRows()"
[getRowId]="getRowId"
[readOnlyEdit]="true"
(cellEditRequest)="onCellEditRequest($event)"
/>
在 resolver 返回完整记录时调用 openRecord()。同一记录的单据头更新不会重新初始化行草稿;用户明确放弃修改、重新加载或接受服务端结果时,再通过单独的重置流程替换草稿。
这个模式下,新增和删除也必须修改 draftRows。如果继续只调用 applyTransaction,下一次 signal 更新仍可能覆盖那些仅存在于表格内部的行变更。
示例使用普通扁平对象。如果实际的 GridRow 包含嵌套对象或类方法,应使用合适的草稿构造或复制方法;对象展开只进行浅拷贝,也不会保留类原型。
为什么还要配置 getRowId?
getRowId 让 AG Grid 根据稳定 ID 匹配行。配合不可变更新,应用为修改过的行创建新对象,为行集合创建新数组,表格就可以识别新增、更新和删除,而不必把所有行都当成全新的行。AG Grid Row Data 更新说明
getRowId 不能解决数据冲突。传入旧数据时,旧字段仍可能覆盖当前值;新数组中缺少的行仍可能被删除。它负责识别行,不负责判断哪份业务数据应该保留。
不要使用数组下标作为行 ID。新增行也需要稳定的临时 ID,并在服务端分配正式 ID 后明确处理映射。
还能继续使用 linkedSignal 吗?
可以。linkedSignal 的对象形式提供 source、computation 和上一次的状态,可据此制定规则:记录 ID 相同时返回 previous.value,记录 ID 改变时重新构造草稿。Angular linkedSignal 的 previous 状态说明
这只能解决草稿何时重置的问题。表格编辑仍应写入这个草稿 signal,新增和删除也应走相同入口。
仅设置按记录 ID 比较的 equal,或者用深度比较避免重复计算,都不能替代更新策略。同一条记录也可能收到真正需要处理的服务端行变更。
什么时候适合由 AG Grid 管理草稿?
如果其他组件不需要实时读取行状态,也可以由 AG Grid 管理草稿:
- 在完整记录加载后初始化表格。
- 默认单元格编辑由 AG Grid 处理,程序化增删改通过
applyTransaction等 API 完成。 - 单据头变化时不重新提交整份
rowData。 - 保存时先结束当前编辑,再提取业务行数据。
在 Client-Side Row Model 下,可以这样收集普通业务行:
const rows: DraftRow[] = [];
api.stopEditing();
api.forEachNode(node => {
if (!node.group && node.data) {
rows.push({ ...node.data });
}
});
forEachNode() 会遍历客户端 row model 中的行,不受当前筛选结果限制,也不保证按当前显示排序返回;固定行需要另行处理。若保存顺序有业务含义,应保存明确的顺序字段。这种读取方式也不能直接获取 Server-Side 或 Infinite Row Model 下尚未加载的全部数据。AG Grid 行访问说明
采用此模式时,初始化数组应被视为加载输入。如果其他组件需要实时行状态,可以选择事件驱动的同步机制,或者改用前面的 signal 草稿模式。
外部行更新和未保存修改如何共存?
单据头更新通常不需要触碰行草稿。如果外部更新确实修改了同一记录的行数据,就必须定义合并规则。例如:
- 未被本地修改的字段可以接受服务端更新。
- 本地和远端修改涉及同一字段时,保留本地值或提示用户处理冲突。
- 本地删除的行需要记录删除标记,避免被服务端快照重新加入。
- 本地新增但尚未保存的行需要继续保留。
需要自动合并时,通常要保留加载时的基线、当前草稿和最新服务端快照,以区分双方各自修改了什么。linkedSignal、getRowId 和 applyTransaction 都不会自动完成这种业务合并。
保存成功后的响应也需要经过相同边界:如果请求期间用户又继续编辑,不能直接用响应覆盖较新的草稿。
备注:内容仅供参考。
