萬盛學電腦網

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

JavaScript 實現雙列表框左右移動數據:選項遷移完整解決方案

功能場景

經典「可用項 ↔ 已選項」雙列表交互:用戶選中左側選項點「>>」移至右側,或選中右側點「<<」移回左側。支援多選、全量移動、順序保持。

核心遷移函數

/**
 * 在兩個 select 之間移動選中選項
 * @param {string} sourceId - 源 select id
 * @param {string} destId   - 目標 select id
 */
function moveOptions(sourceId, destId) {
  var src = document.getElementById(sourceId);
  var dest = document.getElementById(destId);
  
  // 從後向前遍歷,避免索引變化導致漏選
  for (var i = src.options.length - 1; i >= 0; i--) {
    var opt = src.options[i];
    if (opt.selected) {
      // 複製選項(保留 value、text、selected 狀態)
      var newOpt = new Option(opt.text, opt.value, opt.defaultSelected, opt.selected);
      dest.add(newOpt);           // 標準 DOM API
      src.remove(i);              // 從源移除
    }
  }
  
  // 可選:移動後保持目標列表排序
  // sortSelect(destId);
}

// 輔助:按文本排序
function sortSelect(selectId) {
  var sel = document.getElementById(selectId);
  var opts = Array.from(sel.options).sort(function(a, b) {
    return a.text.localeCompare(b.text);
  });
  sel.innerHTML = '';
  opts.forEach(function(o) { sel.add(new Option(o.text, o.value)); });
}

完整可運行示例

<!DOCTYPE html>
<html><head><meta charset="utf-8"><style>
.select-box { display:inline-block; vertical-align:top; margin:0 20px; }
select { width:200px; height:200px; }
.btns { display:inline-block; vertical-align:top; margin-top:60px; }
button { display:block; margin:5px 0; padding:5px 10px; }
</style></head><body>

<div class="select-box">
  <div>可用城市</div>
  <select id="source" multiple>
    <option value="bj">北京</option>
    <option value="sh">上海</option>
    <option value="gz">廣州</option>
    <option value="sz">深圳</option>
    <option value="cd">成都</option>
  </select>
</div>

<div class="btns">
  <button onclick="moveOptions('source', 'dest')">>></button>
  <button onclick="moveOptions('dest', 'source')"><<</button>
</div>

<div class="select-box">
  <div>已選城市</div>
  <select id="dest" multiple></select>
</div>

<script>
// 上方 moveOptions 函數代碼
</script>
</body></html>

進階增強

1. 雙擊直接移動

$('#source, #dest').on('dblclick', 'option', function() {
  var $src = $(this).parent();
  var $dest = $src.is('#source') ? $('#dest') : $('#source');
  $dest.append(this); // 原生 DOM 移動,極簡高效
});

2. 全量移動按鈕

function moveAll(sourceId, destId) {
  var src = document.getElementById(sourceId);
  var dest = document.getElementById(destId);
  while (src.options.length) {
    dest.add(src.options[0]); // 依次移動第一項
  }
}

3. 表單提交時自動選中所有目標項(確保提交)

$('form').on('submit', function() {
  $('#dest option').prop('selected', true);
});

現代框架中的對應實現

  • Vue:雙向綁定兩個數組 sourceList、destList,按鈕觸發 splice/push 即可,無需操作 DOM。
  • React:同理,state 中維護兩個數組,onClick 更新 state。
  • 原生 Web Component:封裝為 `` 自定義元素,Shadow DOM 隔離樣式。

總結

原生 select.add()/remove() 配合逆序遍歷,是雙列表遷移最穩健的原生實現。現代項目建議採用「數據驅動視圖」模式,將邏輯遷移到數組操作層,僅在必要時操作 DOM,減少副作用與 Bug。

copyright © 萬盛學電腦網 all rights reserved