基於 jQuery 的多級聯動(省市區、分類層級等)是後台管理系統的高頻需求。本文提供一個**數據驅動、支持無限級、可復用**的封裝方案,並解決「編輯頁回填」「異步加載」「選項過多」等實戰痛點。
id、parent_id、name,後端一次性返回扁平數組,前端構建樹或按需查詢。data-* 屬性標記層級關係,JS 僅操作選項,不綁死具體 HTML 結構。// 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>
*/
引入 Choices.js 或 Select2,將 <select> 升級為可搜索下拉框:
this.$selects.each((i, el) => new Choices(el, {searchEnabled: true, removeItemButton: true}));
修改 _getOptions 返回 Promise,change 事件中 await 獲取子級數據再渲染,並顯示 Loading 狀態。
在 onChange 回調中檢查最後一級是否有值,動態設置 required 屬性或顯示錯誤提示。
| 維度 | jQuery 封裝 | 原生 JS (ES6 Class) |
|---|---|---|
| 代碼量 | ~80 行 | ~60 行 |
| 依賴體積 | +30KB (jQuery) | 0 |
| DOM 操作便利性 | 鏈式調用、隱式迭代 | 需手寫循環 |
| 舊瀏覽器兼容 | IE9+ | 需 Polyfill (Map, Class, Arrow) |
若項目已引入 jQuery,本封裝可直接使用;新項目建議改用原生 class CascadeSelect,移除 jQuery 依賴,打包體積更小。