该技能基于 table-core 与 table-features,行聚合可独立于分组使用,用于总计;也可与分组技能结合生成合成分组行。
用途:对列计算聚合值,例如总计、指定行子集合计、多聚合结果。
主要能力:register rowAggregationFeature 并配置 aggregationFns,如 mean、sum。调用 column.getAggregationValue() 得到默认缓存结果;传入 { rows, maxDepth } 显式指定范围,rows 可来自任意行模型或调用方子集,maxDepth 默认 0 表示所给根行,1 表示直接子行,Infinity 表示终端行。列可配置多个聚合:标量返回标量,数组返回键控对象,描述符需带稳定 id。使用 constructAggregationFn 自定义聚合,context 提供 rows、maxDepth、getValue、column、columnId、table 等;可加 merge 合并子行结果。服务器场景可在列定义中设 getAggregationValue(context) 返回 { value },返回 undefined 回退本地;manualAggregation: true 禁用本地回退。getMaxSubRowDepth() 返回核心行模型最深结构深度。
限制:显式 rows 调用不缓存;实验性 worker 只计算分组行模型聚合,公开的 getAggregationValue 在主线程执行;自定义分组结果须可结构化克隆。避免仅为算总计而注册 columnGroupingFeature;不支持传入 scope 标签;旧式 (columnId, leafRows, childRows) 签名已废弃。