同一個頁面裡放了兩個甚至更多 DataTable,點其中任何一個的「全選」複選框,結果所有表格的複選框都被選中了。
這是 jquery.datatable 控件自身的一個缺陷。它內部那個全選 checkbox 小插件的 id 是硬編碼的常量 chk_all。頁面裡一旦初始化多個 datatable,就會生成多個 id 相同的元素——而 HTML 規範要求 id 文檔內唯一。與此同時,插件綁定全選事件時用的是 $("#chk_all") 這樣的選擇器,它必然匹配到頁面上所有同名 id 的元素,於是「一鍵全選全部表格」。
思路很直接:datatable 本身的 id 是不同的,那就把 datatable 的 id 作為前綴,拼出每個表格各自唯一的 checkbox id;同時把所有引用該 id 的事件綁定與狀態同步也換成新 id。
需要修改的文件:jqurey.datatable.ext.js(v0.0.1),共三處。
// 修改前
$("#" + options.select_table).find('thead tr th:first-child')
.prepend('<input type="checkbox" value="CHK_ALL" id="chk_all" />');
// 修改後
$("#" + options.select_table).find('thead tr th:first-child')
.prepend('<input type="checkbox" value="CHK_ALL" id="' + options.select_table + '_chk_all" />');
// 修改前
$("#chk_all").click(function () {
// 修改後
$("#" + $.fn.datatable_ext.defaults.select_table + "_chk_all").click(function () {
單個勾選變化後,需要根據「已勾數是否等於當頁總數」來決定全選框要不要打勾:
// 修改前
if (checked_chk_num == curr_page_chk_num) {
$("#chk_all").attr('checked', 'checked');
} else {
$("#chk_all").removeAttr('checked');
}
// 修改後
if (checked_chk_num == curr_page_chk_num) {
$("#" + $.fn.datatable_ext.defaults.select_table + "_chk_all").attr('checked', 'checked');
} else {
$("#" + $.fn.datatable_ext.defaults.select_table + "_chk_all").removeAttr('checked');
}
寫可複用組件時,凡是要生成 DOM 元素,id 一律要帶上實例前綴,不能假設「一個頁面只有一個」。這是組件化最基本的自律。
另外補一句:在 jQuery 中操作 checkbox 的勾選狀態,較新版本應使用 .prop('checked', true/false) 而非 .attr()。用 attr 在 jQuery 1.6 之後的版本上會出現狀態不同步的問題,屬於同類「能跑但不可靠」的坑。