萬盛學電腦網

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

jQuery 實現多級下拉聯動:數據驅動與遞歸渲染

基於 jQuery 的多級聯動(省市區、分類層級等)是後台管理系統的高頻需求。本文提供一個**數據驅動、支持無限級、可復用**的封裝方案,並解決「編輯頁回填」「異步加載」「選項過多」等實戰痛點。

核心設計原則

  1. 數據結構標準化:每項包含 id、parent_id、name,後端一次性返回扁平數組,前端構建樹或按需查詢。
  2. DOM 與邏輯解耦:通過 data-* 屬性標記層級關係,JS 僅操作選項,不綁死具體 HTML 結構。
  3. 事件委託 + 命名空間:避免重複綁定、便於銷毀。

完整實現(ES6 + jQuery 3.x)

// linkage.js
class CascadeSelect {
  /**
   * @param {Object} options
   *   - container: String|jQuery  容器選擇器,內部包含多個 <select class="cascade">
   *   - data: Array              扁平數據 [{id, parent_id, name, ...}]
   *   - rootValue: Any           頂層父級 ID,默認 0
   *   - placeholder: String      默認提示文字
   *   - onChange: Function       任意級別變化回調 (level, selectedItems)
   */
  constructor(options = {}) {
    this.opt = Object.assign({
      container: '.cascade-container',
      data: [],
      rootValue: 0,
      placeholder: '請選擇',
      onChange: null
    }, options);

    this.$container = $(this.opt.container);
    this.$selects = this.$container.find('select.cascade');
    this.tree = this._buildTree(this.opt.data);
    this._bindEvents();
    this._initFirstLevel();
  }

  // 扁平數組 -> 樹形結構 {id: {children: [], ...}}
  _buildTree(data) {
    const map = {};
    data.forEach(item => map[item.id] = {...item, children: []});
    const roots = [];
    data.forEach(item => {
      const parent = map[item.parent_id];
      if (parent) parent.children.push(map[item.id]);
      else roots.push(map[item.id]);
    });
    return { children: roots }; // 虛擬根節點
  }

  // 獲取指定層級的選項數組
  _getOptions(parentId) {
    const node = this._findNode(this.tree, parentId);
    return node?.children || [];
  }

  _findNode(node, id) {
    if (node.id === id) return node;
    for (const child of node.children) {
      const found = this._findNode(child, id);
      if (found) return found;
    }
    return null;
  }

  _bindEvents() {
    this.$container.on('change.cascade', 'select.cascade', e => {
      const $cur = $(e.currentTarget);
      const level = this.$selects.index($cur);
      const val = $cur.val();

      // 更新後續所有級別
      this.$selects.each((i, sel) => {
        if (i <= level) return;
        const $sel = $(sel);
        $sel.empty().append(``).prop('disabled', true);
      });

      if (!val) return this._triggerChange(level);

      const options = this._getOptions(val);
      if (options.length) {
        const $next = this.$selects.eq(level + 1);
        options.forEach(o => $next.append(``));
        $next.prop('disabled', false);
      }
      this._triggerChange(level);
    });
  }

  _initFirstLevel() {
    const firstOptions = this._getOptions(this.opt.rootValue);
    const $first = this.$selects.eq(0);
    $first.empty().append(``);
    firstOptions.forEach(o => $first.append(``));
    $first.prop('disabled', false);
  }

  _triggerChange(changedLevel) {
    if (!this.opt.onChange) return;
    const selected = [];
    this.$selects.each((i, sel) => {
      if (i > changedLevel) return false; // 只收集已確定的級別
      const v = $(sel).val();
      if (v) selected.push({level: i, value: v, text: $(sel).find('option:selected').text()});
    });
    this.opt.onChange(changedLevel, selected);
  }

  // 公開方法:設置值(用於編輯頁回填)
  setValues(values) { // values: [{level, value}, ...]
    values.forEach(({level, value}) => {
      const $sel = this.$selects.eq(level);
      if ($sel.length) {
        $sel.val(value).trigger('change.cascade');
        // 異步等待下一級渲染完成,這裡簡化處理,實際可用 Promise/async
      }
    });
  }

  destroy() {
    this.$container.off('.cascade');
  }
}

// ================= 使用示例 =================
/*
<div class="cascade-container">
  <select class="cascade" name="province"></select>
  <select class="cascade" name="city" disabled></select>
  <select class="cascade" name="district" disabled></select>
</div>

<script>
// 假設後端返回扁平數據
const rawData = [
  {id: 1, parent_id: 0, name: '廣東'},
  {id: 2, parent_id: 1, name: '廣州'},
  {id: 3, parent_id: 2, name: '天河區'},
  // ...
];

const cascade = new CascadeSelect({
  container: '.cascade-container',
  data: rawData,
  onChange: (level, selected) => console.log('當前選中:', selected)
});

// 編輯頁回填
cascade.setValues([
  {level: 0, value: 1},
  {level: 1, value: 2},
  {level: 2, value: 3}
]);
</script>
*/

實戰優化技巧

1. 選項過多時的搜索增強

引入 Choices.js 或 Select2,將 <select> 升級為可搜索下拉框:

this.$selects.each((i, el) => new Choices(el, {searchEnabled: true, removeItemButton: true}));

2. 異步懶加載(萬級數據)

修改 _getOptions 返回 Promise,change 事件中 await 獲取子級數據再渲染,並顯示 Loading 狀態。

3. 表單驗證集成

在 onChange 回調中檢查最後一級是否有值,動態設置 required 屬性或顯示錯誤提示。

與原生 JS 方案對比

維度jQuery 封裝原生 JS (ES6 Class)
代碼量~80 行~60 行
依賴體積+30KB (jQuery)0
DOM 操作便利性鏈式調用、隱式迭代需手寫循環
舊瀏覽器兼容IE9+需 Polyfill (Map, Class, Arrow)

若項目已引入 jQuery,本封裝可直接使用;新項目建議改用原生 class CascadeSelect,移除 jQuery 依賴,打包體積更小。

copyright © 萬盛學電腦網 all rights reserved