PAYATHON 2026

如何同步 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 管理草稿:

  1. 在完整记录加载后初始化表格。
  2. 默认单元格编辑由 AG Grid 处理,程序化增删改通过 applyTransaction 等 API 完成。
  3. 单据头变化时不重新提交整份 rowData。
  4. 保存时先结束当前编辑,再提取业务行数据。

在 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 都不会自动完成这种业务合并。

保存成功后的响应也需要经过相同边界:如果请求期间用户又继续编辑,不能直接用响应覆盖较新的草稿。

备注:内容仅供参考。