萬盛學電腦網

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

JavaScript 實現雙表格數據雙向移動:完整交互邏輯與優化方案

前言

雙列表框雙向移動是權限分配、商品分類、人員選擇等場景的經典交互。本文實現兩個表格間勾選行的來回移動,支持全選、批量移動、狀態保持,並分析性能優化方向。

一、HTML 結構與樣式


<div id="main">
  <!-- 左側:可用項目 -->
  <div id="div1">
    <table id="tab_sendValue1">
      <thead><tr><th><input type="checkbox" id="check_all" onclick="myclick(this, 'item')"> 全選</th><th>ID</th><th>編號</th><th>目的地</th><th>狀態</th><th>日期</th></tr></thead>
      <tbody>
        <tr><td><input type="checkbox" name="item" value="1"></td><td id="id1">ID001</td><td id="no1">NO001</td><td id="des1">北京</td><td id="status1">待發貨</td><td id="date1">2024-01-15</td></tr>
        <tr><td><input type="checkbox" name="item" value="2"></td><td id="id2">ID002</td><td id="no2">NO002</td><td id="des2">上海</td><td id="status2">已發貨</td><td id="date2">2024-01-16</td></tr>
        <!-- 更多行... -->
      </tbody>
    </table>
  </div>
  
  <!-- 中間:操作按鈕 -->
  <div id="div2">
    <button onclick="sendValueToRight()">>> 移至右側 </button>
    <br><br>
    <button onclick="sendValueToLeft()"><< 移至左側 </button>
  </div>
  
  <!-- 右側:已選項目 -->
  <div id="div3">
    <table id="tab_sendValue3">
      <thead><tr><th><input type="checkbox" id="check_all_right" onclick="myclick(this, 'item_right')"> 全選</th><th>ID</th><th>編號</th><th>目的地</th><th>狀態</th><th>日期</th></tr></thead>
      <tbody></tbody>
    </table>
  </div>
</div>

二、核心 JS 邏輯


// 全選/取消全選
function myclick(chkAll, itemName) {
    var items = document.getElementsByName(itemName);
    for (var i = 0; i < items.length; i++) {
        items[i].checked = chkAll.checked;
    }
}

// 左 -> 右
function sendValueToRight() {
    var leftTable = document.getElementById('tab_sendValue1');
    var rightTable = document.getElementById('tab_sendValue3');
    var rightBody = rightTable.tBodies[0] || rightTable; // 兼容無 tbody
    var items = document.getElementsByName('item');
    var rowsToMove = [];
    
    // 1. 收集要移動的行索引 (從大到小排序,避免索引變化)
    for (var i = items.length - 1; i >= 0; i--) {
        if (items[i].checked) {
            var row = items[i].parentNode.parentNode; // input -> td -> tr
            rowsToMove.push({
                row: row,
                data: {
                    id: row.cells[1].textContent,
                    no: row.cells[2].textContent,
                    des: row.cells[3].textContent,
                    status: row.cells[4].textContent,
                    date: row.cells[5].textContent
                }
            });
        }
    }
    
    // 2. 批量移動 (倒序刪除左側,順序添加右側)
    rowsToMove.forEach(function(item) {
        // 添加到右側
        var newRow = rightBody.insertRow(-1); // -1 末尾
        newRow.innerHTML = '<td><input type="checkbox" name="item_right" value="' + item.data.id + '"></td>' +
                           '<td>' + item.data.id + '</td>' +
                           '<td>' + item.data.no + '</td>' +
                           '<td>' + item.data.des + '</td>' +
                           '<td>' + item.data.status + '</td>' +
                           '<td>' + item.data.date + '</td>';
        // 從左側刪除
        leftTable.deleteRow(item.row.rowIndex);
    });
    
    // 3. 重置全選框
    document.getElementById('check_all').checked = false;
    updateRowIndexes(); // 可選:重新排序 ID
}

// 右 -> Left (邏輯對稱)
function sendValueToLeft() {
    var leftTable = document.getElementById('tab_sendValue1');
    var rightTable = document.getElementById('tab_sendValue3');
    var leftBody = leftTable.tBodies[0] || leftTable;
    var items = document.getElementsByName('item_right');
    var rowsToMove = [];
    
    for (var i = items.length - 1; i >= 0; i--) {
        if (items[i].checked) {
            var row = items[i].parentNode.parentNode;
            rowsToMove.push({
                row: row,
                data: {
                    id: row.cells[1].textContent,
                    no: row.cells[2].textContent,
                    des: row.cells[3].textContent,
                    status: row.cells[4].textContent,
                    date: row.cells[5].textContent
                }
            });
        }
    }
    
    rowsToMove.forEach(function(item) {
        var newRow = leftBody.insertRow(-1);
        newRow.innerHTML = '<td><input type="checkbox" name="item" value="' + item.data.id + '"></td>' +
                           '<td>' + item.data.id + '</td>' +
                           '<td>' + item.data.no + '</td>' +
                           '<td>' + item.data.des + '</td>' +
                           '<td>' + item.data.status + '</td>' +
                           '<td>' + item.data.date + '</td>';
        rightTable.deleteRow(item.row.rowIndex);
    });
    
    document.getElementById('check_all_right').checked = false;
}

三、關鍵優化點

1. 索引失效問題:倒序遍歷 + 批量操作

正序刪除行會導致後續行索引前移,造成漏刪或錯刪。解決:先收集所有要移動的行對象/數據,再倒序刪除源表格,順序添加目標表格。

2. 數據與視圖分離 (重構方向)


// 數據模型
var leftData = [ {id:'ID001', no:'NO001', des:'北京', status:'待發貨', date:'2024-01-15'}, ... ];
var rightData = [];

// 渲染函數
function renderTable(tableId, data, checkboxName) {
    var tbody = document.getElementById(tableId).tBodies[0];
    tbody.innerHTML = data.map(function(item, index) {
        return '<tr><td><input type="checkbox" name="' + checkboxName + '" value="' + item.id + '"></td>' +
               '<td>' + item.id + '</td><td>' + item.no + '</td><td>' + item.des + '</td><td>' + item.status + '</td><td>' + item.date + '</td></tr>';
    }).join('');
}

// 移動邏輯變為純數組操作
function moveLeftToRight() {
    var selectedIds = getSelectedIds('item');
    var toMove = leftData.filter(item => selectedIds.includes(item.id));
    leftData = leftData.filter(item => !selectedIds.includes(item.id));
    rightData = rightData.concat(toMove);
    renderTable('tab_sendValue1', leftData, 'item');
    renderTable('tab_sendValue3', rightData, 'item_right');
}

3. jQuery 版本 (簡潔版)


function move($sourceTable, $targetTable, sourceCheckboxName, targetCheckboxName) {
    var $rows = $sourceTable.find('tbody input[name="' + sourceCheckboxName + '"]:checked').closest('tr');
    var html = $rows.map(function() { return this.outerHTML; }).get().join('');
    $targetTable.find('tbody').append(html);
    $rows.remove();
    $sourceTable.find('thead input:checkbox').prop('checked', false);
}

// 使用
$('#btnRight').click(function() { move($('#leftTable'), $('#rightTable'), 'item', 'item_right'); });
$('#btnLeft').click(function() { move($('#rightTable'), $('#leftTable'), 'item_right', 'item'); });

四、進階功能擴展

  • 拖拽排序:集成 SortableJS 實現行內拖拽排序
  • 搜索過濾:每個表格上方添加輸入框,實時過濾顯示行
  • 分頁/虛擬滾動:大數據量時只渲染可視區域
  • 鍵盤操作:空格選中、Enter 移動、方向鍵導航
  • 狀態持久化:localStorage 保存左右表格數據,頁面刷新恢復

五、總結

雙表格數據移動的核心難點在於 DOM 索引同步 和 數據一致性。原始 DOM 操作方案適合簡單場景,但隨著功能增長,數據驅動視圖 (Data-Driven View) 模式 (如 Vue/React 或手動 render 函數) 更易維護、擴展。建議新項目直接採用數據模型 + 渲染函數架構,老項目可通過「收集數據 → 批量操作 → 重渲染」漸進重構。

copyright © 萬盛學電腦網 all rights reserved