萬盛學電腦網

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

jQuery EasyUI Combobox 三種下拉框寫法速查

三種宣告式寫法

1. Input 標籤直接宣告(最常用)

<input id="cc" class="easyui-combobox" name="name" 
    data-options="
        valueField:'value',
        textField:'text',
        data:[
            {'value':'1','text':'Java'},
            {'value':'2','text':'C#'}
        ]
    "
/>

2. DataGrid 欄位編輯器:物件寫法

<th data-options="
    field:'lb',
    editor: {
        type: 'combobox',
        options: {
            data: [{'value':'1','text':'Java'}, {'value':'2','text':'C#'}],
            valueField: 'value',
            textField: 'text'
        }
    }
">類別</th>

3. DataGrid 欄位編輯器:字串寫法(需轉義引號)

<th field="level" 
    editor="{ 
        type:'combobox', 
        options:{ 
            data:[ 
                {'value':'1','text':'Java'}, 
                {'value':'2','text':'C#'} 
            ], 
            valueField:'id', 
            textField:'text'
        }
    }">
    類別</th>

核心屬性對照

屬性說明預設
valueField綁定值的欄位名'value'
textField顯示文字的欄位名'text'
data本地資料陣列[]
url遠端資料 URL(回傳 JSON 陣列)null
editable是否允許輸入文字true
panelHeight下拉面板高度,'auto' 自適應200
multiple是否多選false

動態載入遠端資料

$('#cc').combobox({
    url: '/api/categories',
    valueField: 'id',
    textField: 'name',
    onLoadSuccess: function() {
        // 可選:預設選中第一項
        var data = $(this).combobox('getData');
        if (data.length) $(this).combobox('select', data[0].id);
    }
});

常見坑點

  • valueField 型別不一致:後端回傳 id: 1 (Number),前端 setValue('1') (String) 無法匹配 → 必須 parseInt。
  • data-options 內單引號/雙引號嵌套易報錯 → 建議用字串寫法或外部 JS 初始化。
  • DataGrid 編輯器中 valueField: 'id' 但資料用 value → 欄位名稱必須一致。

結語

三種寫法本質相同:皆透過 data-options 或 editor.options 傳遞配置物件。實務建議統一在 JS 中初始化($('#cc').combobox({...})),HTML 僅保留 <input class="easyui-combobox">,分離結構與行為,利於維護與測試。

copyright © 萬盛學電腦網 all rights reserved