本文介绍如何使用 datatables api 精确获取并操作当前页面可见的行节点，避免全表数据误选，适用于带“全选”功能的分页表格场景。
本文介绍如何使用 datatables api 精确获取并操作当前页面可见的行节点，避免全表数据误选，适用于带“全选”功能的分页表格场景。
在使用 jQuery DataTables 实现带分页的表格时，常见需求是：点击“全选”按钮，仅勾选当前分页显示的行（而非整个数据源的所有记录）。若直接调用过时的 fnGetNodes()（属于旧版 1.9 API），会返回全部页的数据节点，导致逻辑错误。
✅ 正确做法：使用现代 API 获取当前页行节点
DataTables 1.10+ 推荐使用链式 rows() 方法配合 { page: 'current' } 选项：
// 假设 table 是已初始化的 DataTables 实例（非 jQuery 对象）
var currentPageNodes = table.rows({ page: 'current' }).nodes();
// 返回一个包含当前页所有 <tr> DOM 元素的数组（原生 NodeList）<p>如需进一步操作（例如批量添加选中类、触发复选框状态更新），可结合遍历处理：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2331" title="jQuery 1.12.4"><img
src="https://img.php.cn/upload/manual/001/431/639/6a21619eac924328.png" alt="jQuery 1.12.4" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2331" title="jQuery 1.12.4" class="overflowclass">jQuery 1.12.4</a>
<p class="overflowclass">jQuery 1.12.4是jQuery 1.x系列的最后一个正式稳定版本，由jQuery团队于2016年发布。该版本主要面向需要兼容旧版浏览器环境的网站和Web应用，尤其适用于仍需支持Internet Explorer 6、Internet Explorer 7、Internet Explorer 8等老旧浏览器的项目。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2331" title="jQuery 1.12.4" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<pre class="brush:php;toolbar:false;">// 示例：为当前页所有行添加 'selected' 类，并同步复选框状态
var currentPageRows = table.rows({ page: 'current' });
var nodes = currentPageRows.nodes();
$(nodes).addClass('selected');
currentPageRows.every(function() {
var data = this.data();
// 假设每行第一列是 checkbox 单元格
$('input[type="checkbox"]', this.node()).prop('checked', true);
});
⚠️ 注意事项
- 确保
table是通过$('#myTable').DataTable()初始化返回的 API 实例对象，而非 jQuery 包装器（即不要写成$('#myTable').rows(...)）； -
rows({ page: 'current' })返回的是 API 操作对象，需调用.nodes()获取 DOM 节点，或.data()获取数据对象； - 若需获取当前页所有行的原始数据（非 DOM），请改用：
var currentPageData = table.rows({ page: 'current' }).data().toArray(); - 旧版
fnGetNodes()已废弃，不兼容 1.10+，请勿混用。
✅ 总结
精准控制分页上下文是构建健壮表格交互的关键。始终优先使用 rows({ page: 'current' }) 替代全局数据获取方法，既符合 DataTables 最佳实践，也保障了用户操作的直观性与一致性。
