萬盛學電腦網

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

ExtJS ComboBox Store 資料格式完整指南:從陣列到 JsonStore

前言

Ext.form.ComboBox 是 ExtJS 中最常用的下拉選單元件,其 store 設定彈性極高,支援陣列、內建 Store 類別、甚至動態載入。本文系統整理三種主流資料格式與最佳實務。

資料格式一:簡單陣列(適用於靜態、少量選項)

格式 A:二維陣列 [ [value, text], ... ]

var combo = new Ext.form.ComboBox({
    fieldLabel: '統計年份',
    store: [['11', '2011年'], ['12', '2012年'], ['13', '2013年']],
    // 內部自動轉換為 ArrayStore,fields: ['field1', 'field2']
    valueField: 'field1',   // 提交值
    displayField: 'field2', // 顯示文字
    mode: 'local',
    triggerAction: 'all',
    forceSelection: true,
    editable: false
});

格式 B:一維陣列 [value1, value2, ...]

var combo = new Ext.form.ComboBox({
    store: [2011, 2012, 2013, 2014, 2015],
    // 內部自動轉換,valueField 與 displayField 均為 'field1'
    // 提交值 = 顯示值 = 年份數字
    mode: 'local',
    triggerAction: 'all',
    forceSelection: true,
    editable: false
});

資料格式二:JsonStore 遠端載入(標準企業級用法)

// 1. 定義 JsonStore
var projMainStore = new Ext.data.JsonStore({
    url: '/api/dict/items',                    // 後端 API
    fields: ['TEXT', 'VALUE'],                 // 對應後端 JSON 欄位
    root: 'objs',                              // JSON 根節點:{ objs: [...] }
    baseParams: {
        'obj/dicttypeid': 'BM_IMPORTANT_PROJ'  // 固定查詢參數
    },
    autoLoad: true                             // 自動載入
});

// 2. 載入完成後插入「全部」選項
projMainStore.on('load', function(store) {
    store.insert(0, new Ext.data.Record({
        TEXT: '全部',
        VALUE: ''                              // 空值代表不篩選
    }));
});

// 3. 綁定 ComboBox
var projMainType = new Ext.form.ComboBox({
    fieldLabel: '重點工程',
    store: projMainStore,
    valueField: 'VALUE',       // 表單提交值
    displayField: 'TEXT',      // 使用者看到的文字
    mode: 'remote',            // 遠端模式(雖然 store 已 autoLoad)
    triggerAction: 'all',
    selectOnFocus: true,
    forceSelection: true,
    editable: false,
    anchor: '95%'
});

資料格式三:ArrayStore 程式化建立(適合前端動態組裝)

var store = new Ext.data.ArrayStore({
    fields: ['value', 'text'],
    data: [
        ['A', '選項 A'],
        ['B', '選項 B'],
        ['C', '選項 C']
    ]
});

var combo = new Ext.form.ComboBox({
    store: store,
    valueField: 'value',
    displayField: 'text',
    mode: 'local',
    triggerAction: 'all'
});

核心屬性對照表

屬性說明陣列模式預設JsonStore 模式
valueField表單提交時的值field1需對應 fields 定義
displayField下拉顯示的文字field1(一維)或 field2(二維)需對應 fields 定義
mode'local' 客戶端過濾 / 'remote' 伺服器端過濾localremote
triggerAction'all' 點擊展開顯示全部 / 'query' 依輸入過濾allall
forceSelectiontrue 強制只能選清單內選項truetrue
editablefalse 禁止手動輸入,純選單falsefalse

常見問題與最佳實務

  • 「全部」選項值設為空字串:VALUE: '',後端接收時視為「不篩選此欄位」。
  • 遠端模式下的分頁:mode: 'remote' 搭配 pageSize,ComboBox 會自動在下拉清單底部顯示分頁工具列。
  • 模板自訂顯示:使用 tpl 配置自訂下拉項目外觀(如加圖標、多欄顯示)。
  • 避免重複載入:autoLoad: true 會在 Store 建立時立即請求,若 ComboBox 尚未渲染可改用 listeners: { beforerender: function(){ this.getStore().load(); } }。
  • ExtJS 6+ Modern 工具組:改用 Ext.data.Store + Ext.field.Select,API 略有不同但核心概念相同。

總結

ComboBox Store 格式選擇原則:靜態少量用陣列、動態遠端用 JsonStore、前端組裝用 ArrayStore。關鍵在於正確設定 valueField/displayField 對應資料結構,並善用 load 事件注入「全部」等特殊選項。

copyright © 萬盛學電腦網 all rights reserved