萬盛學電腦網

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

jQuery UI Accordion + Sortable 打造可拖拽排序的後台摺疊選單

效果預覽

  • Accordion 摺疊面板:點擊標題展開/收合內容區塊。
  • Sortable 拖拽排序:長按標題拖動調整面板順序。
  • 適用後台側邊欄選單、儀表板區塊自訂排序。

核心依賴

<link rel="stylesheet" href="https://code.jquery.com/ui/1.13.2/themes/base/jquery-ui.css">
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script src="https://code.jquery.com/ui/1.13.2/jquery-ui.min.js"></script>

HTML 結構

<div id="accordion-menu">
    <h3><span class="ui-icon ui-icon-grip-dotted-vertical"></span> 選單一 </h3>
    <div>
        <ul>
            <li><a href="#">子項 1-1</a></li>
            <li><a href="#">子項 1-2</a></li>
        </ul>
    </div>

    <h3><span class="ui-icon ui-icon-grip-dotted-vertical"></span> 選單二 </h3>
    <div>
        <ul><li><a href="#">子項 2-1</a></li></ul>
    </div>

    <h3><span class="ui-icon ui-icon-grip-dotted-vertical"></span> 選單三 </h3>
    <div>
        <ul><li><a href="#">子項 3-1</a></li></ul>
    </div>
</div>

JavaScript 初始化

$(function() {
    // 1. 初始化 Accordion
    $('#accordion-menu').accordion({
        header: '> h3',          // 標題選取器
        collapsible: true,       // 允許全部收合
        active: false,           // 預設全部收合 (或設 0 開啟第一個)
        heightStyle: 'content',  // 高度自適應內容
        icons: {                 // 自訂圖示
            header: 'ui-icon-triangle-1-e',
            activeHeader: 'ui-icon-triangle-1-s'
        }
    });

    // 2. 啟用 Sortable 拖拽排序
    $('#accordion-menu').sortable({
        axis: 'y',               // 垂直拖動
        handle: 'h3',            // 只能拖動標題區
        items: '> div.ui-accordion-header', // 可排序項目 (Accordion 初始化後 h3 會被包裹)
        stop: function(event, ui) {
            // 拖拽結束後,需刷新 Accordion 內部索引
            $(this).accordion('refresh');
            // 可在此儲存新順序至後端
            var order = $(this).find('h3').map(function() { return $(this).text().trim(); }).get();
            console.log('新順序:', order);
        }
    });

    // 3. 修正 Sortable 與 Accordion 的 DOM 結構衝突
    // Accordion 會在 h3 外包一層 
,Sortable items 選取器需對應 // 以上代碼中 items: '> div.ui-accordion-header' 已處理 });

關鍵技術點

問題解決
Accordion 初始化後 DOM 結構改變Sortable 的 items 選取器需針對 Accordion 產生的 wrapper (如 div.ui-accordion-header)
拖拽後 Accordion 內部索引錯亂stop 回調呼叫 accordion('refresh') 重建索引
拖拽手柄視覺提示在 h3 內放置 <span class="ui-icon ui-icon-grip-dotted-vertical"> 作為拖拽把手
動畫衝突拖拽時暫停 Accordion 動畫,或設定 animate: false 於 sortable 期間

進階:持久化順序至後端

stop: function(event, ui) {
    $(this).accordion('refresh');
    var menuOrder = $(this).find('h3').map(function() {
        return $(this).data('menu-id'); // 假設 h3 有 data-menu-id
    }).get().join(',');
    $.post('/api/menu/reorder', { order: menuOrder });
}

現代替代方案 (無 jQuery UI 依賴)

總結

jQuery UI Accordion + Sortable 以極少代碼實現「可摺疊 + 可拖拽排序」的後台選單。核心在於正確設定 Sortable 的 handle、items 選取器,並在 stop 回調呼叫 accordion('refresh')。新專案建議採用現代無依賴庫,架構更清晰、打包體積更小。

copyright © 萬盛學電腦網 all rights reserved