在許多後台管理系統裡,表格中的數據往往需要人工調整先後順序,例如自定義商品展示次序。本文以 jQuery EasyUI 的 DataGrid 為例,記錄如何實現單行的上移、下移,以及如何把調整後的順序持久化保存。
EasyUI 渲染出來的表格有著固定的 DOM 結構:外層容器的 class 為 datagrid-view,而每一行 tr 都帶有 id 與 datagrid-row-index 屬性。
關鍵點在於:移動行之後,必須把這兩行元素的 id 和 datagrid-row-index 相互對調。這樣才能保證 datagrid-row-index=0 始終對應頁面上顯示的第一行,等於 1 的則是第二行,以此類推。後續保存排序時,正是依賴這個屬性來定位每一行的數據。
function move(isUp) {
var selections = $dg.datagrid('getSelections');
if (selections.length == 0) {
return;
}
var $view = $('div.datagrid-view');
var index = $dg.datagrid('getRowIndex', selections[0]);
var $row = $view.find('tr[datagrid-row-index=' + index + ']');
if (isUp) {
$row.each(function () {
var prev = $(this).prev();
var prevId = prev.attr('id');
var prevDatagridRowIndex = prev.attr('datagrid-row-index');
var thisId = $(this).attr('id');
var thisDatagridRowIndex = $(this).attr('datagrid-row-index');
prev.length && $(this).insertBefore(prev);
$(this).attr('id', prevId);
$(this).attr('datagrid-row-index', prevDatagridRowIndex);
prev.attr('id', thisId);
prev.attr('datagrid-row-index', thisDatagridRowIndex);
});
} else {
$row.each(function () {
var next = $(this).next();
var nextId = next.attr('id');
var nextDatagridRowIndex = next.attr('datagrid-row-index');
var thisId = $(this).attr('id');
var thisDatagridRowIndex = $(this).attr('datagrid-row-index');
next.length && $(this).insertAfter(next);
$(this).attr('id', nextId);
$(this).attr('datagrid-row-index', nextDatagridRowIndex);
next.attr('id', thisId);
next.attr('datagrid-row-index', thisDatagridRowIndex);
});
}
}
每一個 tr 由若干個 td 組成,每個 td 都帶有 field 屬性,對應表格所展示對象的屬性名。以下示例中 goodsId 是商品的主鍵。每個 td 內還嵌套一個 div,逐層 find 找到這個 div 後,便能取到對應的值。
下面的做法是先按照當前行序遍歷整個表格,把每一行的主鍵依次拼接成以逗號分隔的字符串,再隨表單一併提交到後端。
function nextStep() {
var arrayData = $dg.datagrid('getData').rows;
var $view = $('div.datagrid-view');
if (arrayData.length != 0) {
saveIds = '';
for (var index = 0; index < arrayData.length; index++) {
var goodsId = $view.find('tr[datagrid-row-index=' + index + ']').find("td[field='goodsId']").find('div').html();
saveIds += goodsId;
if (index != arrayData.length - 1) {
saveIds += ',';
}
}
$.ajax({
url: '${pageContext.request.contextPath}/coupons/getTemplateId',
type: 'post',
dataType: 'json',
success: function (result) {
window.location.href = "${pageContext.request.contextPath}/coupons/tpl" + result + "?goodsId=" + saveIds;
}
});
}
}
以上就是借助 jQuery EasyUI DataGrid 完成行上移、下移並保存排序結果的完整思路。核心在於同步維護 datagrid-row-index,讓 DOM 的顯示順序與數據的邏輯順序保持一致。