後台標籤管理、導航排序、拖拽排序降級方案中,「上移、下移、置頂」是高頻交互。本文基於 jQuery 節點操作 API (clone/prev/next/before/after/prepend) 實現完整功能,代碼結構清晰、邊界判斷完善、支持事件委託,可直接集成到 AdminLTE、Element Admin 等後台模板中。
<div class="showAndHide_list_box">
<div class="showAndHide_box">
<span>標籤一</span>
<a href="javascript:;" class="up">上移</a>
<a href="javascript:;" class="down">下移</a>
<a href="javascript:;" class="top">置頂</a>
</div>
<div class="showAndHide_box">...</div>
<!-- 更多 -->
</div>
var TagManager = {
// 共用容器類名
_itemClass: "showAndHide_box",
_listSelector: ".showAndHide_list_box",
// 獲取當前項目根節點
_getItem: function($trigger) {
return $trigger.closest("." + this._itemClass);
},
// 置頂:移動到列表首位
setTop: function(trigger) {
var $item = this._getItem(trigger).clone(true); // true: 複製事件綁定
this._getItem(trigger).remove();
$(this._listSelector).prepend($item);
},
// 上移:與前一個同級節點交換位置
setUp: function(trigger) {
var $item = this._getItem(trigger);
var $prev = $item.prev("." + this._itemClass);
if ($prev.length) {
var $clone = $item.clone(true);
$prev.before($clone); // 插到前一個之前
$item.remove();
} else {
this._tips("已經是第一個,無法上移");
}
},
// 下移:與後一個同級節點交換位置
setDown: function(trigger) {
var $item = this._getItem(trigger);
var $next = $item.next("." + this._itemClass);
if ($next.length) {
var $clone = $item.clone(true);
$next.after($clone); // 插到後一個之後
$item.remove();
} else {
this._tips("已經是最後一個,無法下移");
}
},
// 統一提示(可替換為 Toast/Message 組件)
_tips: function(msg) {
alert(msg); // 生產環境換 layer.msg / toastr / Element UI Message
}
};
// 事件委託綁定(支持動態新增項目)
$(document).on("click", ".up", function() { TagManager.setUp(this); });
$(document).on("click", ".down", function() { TagManager.setDown(this); });
$(document).on("click", ".top", function() { TagManager.setTop(this); });
.clone(true) 深度複製事件:參數 true 表示同時複製綁定在元素上的事件處理器(jQuery 內部數據),避免移動後按鈕失效。原生 cloneNode(true) **不複製**事件監聽器。clone 再 remove 原節點,再 before/after/prepend 插入克隆節點。這比直接操作 insertBefore 更直觀,也避免了節點在文檔中瞬間消失導致的選中閃爍。$prev.length / $next.length 判斷是否存在相鄰節點,給出友好提示而非靜默失效。$(document).on("click", ".up", fn) 綁定在靜態父級上,動態新增的標籤自動生效,無需重新綁定。function saveOrder() {
var order = [];
$(".showAndHide_box").each(function(i) {
order.push({ id: $(this).data("id"), sort: i + 1 });
});
$.post("/api/tags/reorder", { list: order }, function(res) {
if (res.code === 0) TagManager._tips("保存成功");
});
}
// 在每次移動操作後調用,或提供「保存排序」按鈕統一提交
$(".save-order-btn").click(saveOrder);
現代瀏覽器支持 draggable="true" + dragstart/over/drop/end 事件,可實現原生拖拽排序,體驗更自然。但:
按鈕式上移/下移/置頂作為**兜底方案**,保證全平台、全設備、無障礙環境下均可用,是成熟後台系統的必備交互。
| 坑點 | 後果 | 修正 |
|---|---|---|
用 clone() 不帶 true | 移動後按鈕點擊無反應 | 必須 .clone(true) |
直接 $item.insertBefore($prev) | jQuery 對象插入會移動原節點,但事件綁定可能丟失(舊版本) | 統一用 clone+remove 模式 |
| 未清理數據屬性 | 排序後 data-id 與頂層索引不一致 | 依賴 data-id 而非索引標識實體 |
| 高頻操作未防抖 | 快速連點發送大量保存請求 | 節流防抖、或僅「保存按鈕」提交 |
掌握這套節點操作模式,不僅能解決標籤排序,同樣適用於菜單排序、表單字段順序調整、儀表盤組件布局調整等所有「列表項重排序」場景。