萬盛學電腦網

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

JavaScript 實現 ListBox 選項上移、下移、左右互移完整範例

前言

在 Web 表單開發中,經常需要讓使用者在兩個下拉選單之間移動選項,並對已選項目進行排序。本文提供一個純 JavaScript 實作的完整範例,支援雙擊、按鈕點擊、多選等多種操作方式,程式碼精簡易懂,可直接套用至專案中。

核心功能

  • 雙向移動:支援將選項從左側移至右側,或反向移回
  • 多選支援:按住 Ctrl 或 Shift 鍵可一次選取多個選項
  • 雙擊操作:直接雙擊選項即可快速移動
  • 順序調整:右側選單支援上移、下移按鈕調整優先順序
  • 即時回填:移動完成後自動將選中值寫入隱藏欄位

HTML 結構

頁面包含兩個 <select multiple> 元素,中間放置操作按鈕,右側另附排序按鈕:

<form name="myform">
  <table>
    <tr>
      <td><select name="list1" multiple size="12" ondblclick="moveOption(list1, list2)">...</select></td>
      <td align="center">
        <input type="button" value=">>" onclick="moveOption(list1, list2)"><br><br>
        <input type="button" value="<<" onclick="moveOption(list2, list1)">
      </td>
      <td><select name="list2" multiple size="12" ondblclick="moveOption(list2, list1)"></select></td>
      <td>
        <button onclick="changepos(list2, -1)">▲</button><br>
        <button onclick="changepos(list2, 1)">▼</button>
      </td>
    </tr>
  </table>
  <input type="text" name="city" size="40" readonly>
</form>

關鍵 JavaScript 函式

移動選項:moveOption()

function moveOption(fromSelect, toSelect) {
  try {
    for (var i = 0; i < fromSelect.options.length; i++) {
      if (fromSelect.options[i].selected) {
        var opt = fromSelect.options[i];
        toSelect.appendChild(opt);  // 直接移動 DOM 節點
        i--;  // 索引回退,因為選項已被移除
      }
    }
    updateHiddenValue();  // 同步更新隱藏欄位
  } catch (e) {
    console.error("移動選項失敗:", e);
  }
}

調整順序:changepos()

function changepos(selectObj, direction) {
  // direction: -1 為上移,1 為下移
  var selectedIndex = -1;
  for (var i = 0; i < selectObj.options.length; i++) {
    if (selectObj.options[i].selected) {
      selectedIndex = i;
      break;
    }
  }
  if (selectedIndex === -1) return;

  var targetIndex = selectedIndex + direction;
  if (targetIndex < 0 || targetIndex >= selectObj.options.length) return;

  // 交換兩個選項的位置
  var tempText = selectObj.options[selectedIndex].text;
  var tempValue = selectObj.options[selectedIndex].value;
  selectObj.options[selectedIndex].text = selectObj.options[targetIndex].text;
  selectObj.options[selectedIndex].value = selectObj.options[targetIndex].value;
  selectObj.options[targetIndex].text = tempText;
  selectObj.options[targetIndex].value = tempValue;

  // 保持選中狀態
  selectObj.options[targetIndex].selected = true;
  updateHiddenValue();
}

同步隱藏欄位

function updateHiddenValue() {
  var values = [];
  for (var i = 0; i < document.myform.list2.options.length; i++) {
    values.push(document.myform.list2.options[i].value);
  }
  document.myform.city.value = values.join(",");
}

完整程式碼下載

完整可執行的 HTML 檔案已包含所有省市選項資料,可直接複製使用。建議將 JavaScript 部分抽離為獨立 .js 檔案,HTML 中僅保留結構與引用,便於維護。

適用場景與擴充建議

  • 後台管理系統的權限分配、角色選單設定
  • 電商網站的商品分類多選、標籤管理
  • 可擴充:加入搜尋過濾、拖曳排序、鍵盤快捷鍵支援
  • 現代專案建議改用 Vue/React 元件化實作,並搭配 SortableJS 等庫

這個範例雖然使用傳統 DOM 操作,但邏輯清晰、無外部依賴,適合快速原型開發或維護舊專案。若專案已使用 jQuery,可進一步簡化程式碼;新專案建議採用現代框架的雙向綁定特性實現更優雅的資料流控制。

copyright © 萬盛學電腦網 all rights reserved