AG Grid React 的 onRowSelected 事件可通过 event.source === 'checkboxSelected' 精准区分复选框触发的选择操作与鼠标点击行触发的选择，从而实现仅响应用户勾选/取消勾选行为的业务逻辑。
ag grid react 的 `onrowselected` 事件可通过 `event.source === 'checkboxselected'` 精准区分复选框触发的选择操作与鼠标点击行触发的选择，从而实现仅响应用户勾选/取消勾选行为的业务逻辑。
在 AG Grid React 中，启用行复选框（如通过 rowSelection: 'multiple' 和 checkboxSelection: true）后，所有行选择操作（包括点击复选框和点击整行）都会触发 onRowSelected 事件。但默认情况下，该事件无法直接区分触发来源——这正是开发者常遇到的痛点：需仅响应“用户主动勾选/取消复选框”这一动作，而非因点击行导致的连带选中。
幸运的是，AG Grid 在 onRowSelected 事件对象中提供了 source 属性，它明确标识了选择操作的触发源。当且仅当用户点击复选框时，event.source 的值为 'checkboxSelected'；若通过点击行、键盘导航（如空格键）或 API 调用（如 node.setSelected()）触发，则 source 会是 'uiEvent'、'keyboard' 或 'api' 等其他值。
因此，正确做法是在 onRowSelected 回调中判断 event.source：
import { useCallback } from 'react';
const onRowSelected = useCallback((event: RowSelectedEvent) => {
// 仅处理由复选框触发的选择变更
if (event.source === 'checkboxSelected') {
const isSelected = event.node.isSelected();
console.log(`复选框${isSelected ? '已勾选' : '已取消'} — 行数据:`, event.data);
// ✅ 此处执行你的业务逻辑，例如：
// - 更新本地选中状态数组
// - 触发 API 提交变更
// - 启用/禁用操作按钮
}
}, []);
⚠️ 注意事项：
- event.source 是 AG Grid v28+ 的稳定特性，确保你使用的是较新版本（推荐 ≥ v29）；
- 不要依赖 event.node.selected（已废弃），应始终调用 event.node.isSelected() 获取最新状态；
- 若启用了 suppressRowClickSelection: true，可进一步避免点击行触发选择，使行为更纯粹；
- 该方案无需额外监听 DOM 事件或封装自定义复选框，完全基于 AG Grid 官方事件机制，兼容性好、维护成本低。
总结：无需寻找“专用复选框事件”，AG Grid 已通过 event.source 字段为你提供了精准的上下文识别能力。善用它，即可干净、可靠地实现仅响应复选框交互的业务需求。
