萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實現標籤列表上移、下移、置頂操作:節點操作最佳實踐

後台標籤管理、導航排序、拖拽排序降級方案中,「上移、下移、置頂」是高頻交互。本文基於 jQuery 節點操作 API (clone/prev/next/before/after/prepend) 實現完整功能,代碼結構清晰、邊界判斷完善、支持事件委託,可直接集成到 AdminLTE、Element Admin 等後台模板中。

HTML 結構假設

<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>

核心 JS 模塊化實現

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); });

關鍵技術點解析

  1. .clone(true) 深度複製事件:參數 true 表示同時複製綁定在元素上的事件處理器(jQuery 內部數據),避免移動後按鈕失效。原生 cloneNode(true) **不複製**事件監聽器。
  2. 「移除舊 + 插入新」模式**:先 clone 再 remove 原節點,再 before/after/prepend 插入克隆節點。這比直接操作 insertBefore 更直觀,也避免了節點在文檔中瞬間消失導致的選中閃爍。
  3. 邊界判斷:$prev.length / $next.length 判斷是否存在相鄰節點,給出友好提示而非靜默失效。
  4. 事件委託:$(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);

對比:原生 Drag & Drop API 實現拖拽排序

現代瀏覽器支持 draggable="true" + dragstart/over/drop/end 事件,可實現原生拖拽排序,體驗更自然。但:

  • 移動端不支持(需 Touch 模擬庫如 SortableJS)。
  • 無障礙支持較弱(需大量 ARIA 補充)。
  • 複雜列表(巢狀、虛擬滾動)實現難度大。

按鈕式上移/下移/置頂作為**兜底方案**,保證全平台、全設備、無障礙環境下均可用,是成熟後台系統的必備交互。

避坑指南

坑點後果修正
用 clone() 不帶 true移動後按鈕點擊無反應必須 .clone(true)
直接 $item.insertBefore($prev)jQuery 對象插入會移動原節點,但事件綁定可能丟失(舊版本)統一用 clone+remove 模式
未清理數據屬性排序後 data-id 與頂層索引不一致依賴 data-id 而非索引標識實體
高頻操作未防抖快速連點發送大量保存請求節流防抖、或僅「保存按鈕」提交

掌握這套節點操作模式,不僅能解決標籤排序,同樣適用於菜單排序、表單字段順序調整、儀表盤組件布局調整等所有「列表項重排序」場景。

copyright © 萬盛學電腦網 all rights reserved