Tabulator 的 rowMoved 事件仅传递被移动的 row 对象，不直接提供目标位置参数；但可通过访问 row._row.position 获取其移动后的新索引位置，从而满足前后端同步等实际需求。
tabulator 的 `rowmoved` 事件仅传递被移动的 `row` 对象，不直接提供目标位置参数；但可通过访问 `row._row.position` 获取其移动后的新索引位置，从而满足前后端同步等实际需求。
在使用 Tabulator 实现拖拽排序（row moving）功能时，开发者常需将行的新顺序持久化到服务端。官方文档明确指出：rowMoved 事件的回调函数仅接收一个参数——即被移动的 RowComponent 实例，并不像某些 UI 库那样提供 fromIndex 和 toIndex 等显式目标位置参数。
然而，该 RowComponent 对象内部隐含了当前渲染位置信息。通过深入 inspect row._row（Tabulator 内部 Row 对象），可安全访问其 position 属性——它表示该行在当前表格数据数组（filtered & sorted 后）中的 0-based 索引，即移动完成后的最终位置。
✅ 正确用法示例：
table.on("rowMoved", function(row) {
const newPosition = row._row.position; // ✅ 移动后的真实位置（整数）
const rowData = row.getData(); // 获取对应数据对象
const rowId = rowData.id; // 假设数据有唯一 id 字段
console.log(`Row ${rowId} moved to position ${newPosition}`);
// 发送至后端更新顺序（例如：PATCH /api/items/order）
fetch('/api/items/order', {
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
id: rowId,
position: newPosition
})
});
});
⚠️ 注意事项：
- row._row.position 是 Tabulator 内部属性，虽在 v5.4+ 中稳定可用，但属非公开 API；建议在升级 Tabulator 版本后回归验证；
- 该位置是逻辑位置（即经过滤、排序后的视图索引），而非原始 data 数组索引。如需原始数据顺序，应结合 table.getData() 手动查找；
- 避免依赖 rowMouseUp 或其他鼠标事件模拟目标位置——易与 Tabulator 自身拖拽逻辑冲突，导致位置计算错误或重复触发；
- 若启用分页（pagination），position 仅反映当前页内索引，跨页移动需配合 table.getPage() 和 table.getPageSize() 进行换算。
? 最佳实践：将 row._row.position 与 row.getData() 结合，构建带位置信息的标准化更新载荷，确保前后端排序状态一致。此方案简洁、可靠，已在生产环境广泛验证。
