萬盛學電腦網

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

jQuery UI Combobox 多選在 IE10 不相容問題解決方案

jQuery UI Combobox 在 IE10 環境下啟用 multiple: true 時會拋出 indexOf is not a function 錯誤。本文分析根因並提供兩種修正方案。

錯誤現象

// jQuery UI 內部原始碼片段 (約 10650 行)
function _7e8(_7e9, _7ea) {
    var _7eb = $.data(_7e9, "combobox");
    var opts = _7eb.options;
    var _7ec = $(_7e9).combo("getValues"); // 回傳陣列
    var _7ed = _7ec.indexOf(_7ea + "");   // ❌ IE10 陣列無 indexOf 方法
    if (_7ed >= 0) {
        _7ec.splice(_7ed, 1);
        _7e7(_7e9, _7ec);
    }
}

根因分析

  • Array.prototype.indexOf 是 ES5 新增方法
  • IE9 開始支援,但 **IE10 某些文件模式/相容性檢視下表現不一**
  • jQuery UI 內部直接呼叫原生 indexOf 未做 polyfill 防護

方案一:修改 jQuery UI 原始碼(推薦,精準修復)

找到錯誤行所在檔案(通常是 jquery.ui.combobox.js 或打包後的 jquery-ui.js),將 indexOf 呼叫替換為相容寫法:

// 原始碼
var _7ed = _7ec.indexOf(_7ea + "");

// 修改為:手動實作 indexOf 邏輯
var _7ed = (function(arr, str) {
    str = str + "";
    for (var i = 0, l = arr.length; i < l; i++) {
        if (arr[i] == str) return i;
    }
    return -1;
})(_7ec, _7ea);

方案二:全域 Polyfill(通用,一勞永逸)

在頁面載入最早期(所有腳本之前)引入:

<script>
// Array.prototype.indexOf Polyfill (MDN 標準實作)
if (!Array.prototype.indexOf) {
    Array.prototype.indexOf = function(searchElement, fromIndex) {
        if (this == null) throw new TypeError('"this" is null or not defined');
        const o = Object(this);
        const len = o.length >>> 0;
        if (len === 0) return -1;
        
        const n = fromIndex | 0;
        let k = Math.max(n >= 0 ? n : len - Math.abs(n), 0);
        
        while (k < len) {
            if (k in o && o[k] === searchElement) return k;
            k++;
        }
        return -1;
    };
}

// 同理補上 forEach, filter, map, reduce 等 ES5 陣列方法
if (!Array.prototype.forEach) { /* ... */ }
if (!Array.prototype.filter) { /* ... */ }
</script>

方案三:升級/替換元件庫(根治)

jQuery UI 已停止維護(2021 宣布結束),建議遷移至現代替代方案:

庫特色多選支援體積
Select2成熟、功能豐富、主題化內建 multiple: true~20KB gz
Choices.js無 jQuery 依賴、ES6 模組化原生支援~15KB gz
Tom SelectSelectize 分支、無依賴、效能佳原生支援~12KB gz
Vue Select / React Select框架整合、TypeScript 支援第一類公民視框架

Select2 遷移範例

<!-- HTML -->
<select id="multiSelect" multiple="multiple" style="width: 100%">
    <option value="1">選項 1</option>
    <option value="2">選項 2</option>
    <option value="3">選項 3</option>
</select>

<!-- JS -->
$('#multiSelect').select2({
    placeholder: '請選擇...',
    allowClear: true,
    closeOnSelect: false, // 多選時不自動關閉
    tags: true // 允許輸入新標籤
});

// 取值
$('#multiSelect').val(); // ['1', '3']

// 設值
$('#multiSelect').val(['1', '2']).trigger('change');

驗證修復

<script>
// 測試 indexOf 相容性
console.log([1,2,3].indexOf(2)); // 1
console.log(['a','b'].indexOf('c')); // -1

// 測試 Combobox 多選
$('#combobox').combobox({ multiple: true });
$('#combobox').combobox('setValues', ['1', '3']);
console.log($('#combobox').combobox('getValues')); // ['1', '3']
</script>

總結建議

  1. **緊急修復**:專案無法升級時,用方案二全域 Polyfill(風險最低)
  2. **精準修復**:只改動受影響元件,用方案一修改源碼
  3. **長期規劃**:**儘快遷移至現代選擇器庫**(Select2/Choices.js/Tom Select),jQuery UI 已不再維護,IE11 也於 2022/6/15 終止支援
  4. **測試矩陣**:CI/CD 必須包含 IE11(如仍需支援)的自動化測試
copyright © 萬盛學電腦網 all rights reserved