列表頁做批次處理時,全選與反選幾乎是標配。

我第一次做這個功能時只求跑得快,之後想抽成公用 JS,寫出來的東西實在不好意思拿出來——本質上只是把實作程式碼整段搬進共用檔,然後要求每個頁面沿用同一組 id 與 class。那與其說是封裝,不如說是換了個地方放。後來看到同事的版本,才知道差距在哪:
$(':checkbox[data-check-target]').click(function () { var target = $(this).attr('data-check-target'); if ($(this).prop('checked')) { $(target).prop('checked', true); } else { $(target).prop('checked', false); } });
這段的高明之處在於,JS 與 HTML 之間只靠一個自訂屬性 data-check-target 溝通。我當初用了兩個 hook(一個全選、一個子選),把能標的都標上,結果耦合反而更重。看到這幾行時我很好奇:它是怎麼用單一連接點把三個相關元素串起來的?
接著看使用端:

全選核取方塊上的自訂屬性寫法有點不尋常,值居然是個選擇器:
<input type="checkbox" data-check-target=".id-checkbox" />
繼續往下看子核取方塊:
<input type="checkbox" name="ids[]" value="@item.Id" class="id-checkbox" />
至此才恍然大悟——子核取方塊的 class 名稱就寫在 data-check-target 裡,再透過它取回:
var target = $(this).attr('data-check-target');
歸納起來就是:JS 與 HTML 藉 data-check-target 通信,子核取方塊則依賴這個屬性所提供的 class 名稱。程式碼本身沒有難懂的地方,真正的巧思在於用一個自訂屬性完成了低耦合,讓同一段 JS 稍改屬性值就能套到任何列表上。
補充:為何用 prop 而非 attr
如果 input 在初始 HTML 中並未寫入 checked 屬性,attr('checked') 會回傳 undefined,永遠判斷不出使用者是否勾選。原則上,元素本身固有的屬性(checked、selected、disabled)用 prop;我們自己新增的 DOM 屬性(data-* 這類)用 attr。