DIV CSS 佈局教程網

ExtJs ComboBox 的 store 數據格式用法介紹
編輯:JavaScript綜合知識     

ComboBox 的數據來源由 store 決定,而 store 支持幾種不同的數據形式。理清它們的差別,才能正確控制「提交值」與「顯示值」。

一、直接寫數組

var p_years = new Ext.form.ComboBox({
  fieldLabel: '統計年份',
  anchor: anchor_w,
  mode: 'remote',
  maxHeight: 100,
  triggerAction: 'all',
  selectOnFocus: true,
  forceSelection: true,
  editable: false,

  // 第一種:二維數組,前者為 value,後者為 text
  // store: [['11', '2011'], ['12', '2012'], ['13', '2013']]

  // 第二種:一維數組,未指定 value 與 text 時,提交值與顯示值相同
  store: [2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018]
});

第一種形式是三 (?) 元組結構 [value, text],提交的是前者,展示的是後者。第二種形式最省事,適合年份、狀態這類值與顯示內容一致的場景。

二、從數據庫同步數據字典

更正規的用法是異步加載數據字典,用 JsonStore 從後端取數據:

var proj_main_store = new Ext.data.JsonStore({
  url: "************",
  fields: ['TEXT', 'VALUE'],
  root: "objs",
  baseParams: {
    "obj/dicttypeid": "BM_IMPORTANT_PROJ"
  }
});

// 加載完成後在最前面插入一個「全部」選項
proj_main_store.addListener("load", function () {
  proj_main_store.insert(0, new Ext.data.Record({
    'TEXT': '全部',
    'VALUE': ""
  }));
});

var proj_main_type = new Ext.form.ComboBox({
  fieldLabel: '重點工程',
  anchor: anchor_w,
  mode: 'remote',
  triggerAction: 'all',
  selectOnFocus: true,
  forceSelection: true,
  editable: false,
  valueField: 'VALUE',   // 實際提交的值對應的字段
  displayField: 'TEXT',  // 界面上顯示的文本對應的字段
  store: proj_main_store
});

關鍵配置解析

要理解 ComboBox 的取值行為,需要區分四個配置:

  • store:數據來源。
  • fields:JsonStore 中聲明每條記錄包含哪些字段。
  • valueField:選中後表單真正提交的值所對應的字段名。
  • displayField:輸入框裡顯示的文本所對應的字段名。

mode: 'remote' 表示數據異步加載,此時 triggerAction: 'all' 很重要——它讓每次展開都查詢全部數據,而不是按輸入內容過濾(那是 'query' 的行為,配合 mode: 'remote' 才能做遠程搜索)。editable: false 禁止手輸,forceSelection: true 則保證必須選中列表項,兩者結合可以避免提交任意值。

root: "objs" 指定 JSON 中記錄數組所在的屬性名,這要求後端返回形如 {"objs": [{"TEXT": "...", "VALUE": "..."}], "total": 10} 的結構。若使用分頁,還需要配置 totalProperty。

幾點實踐建議

在 load 監聽裡 insert 一條「全部」,是常見但略顯笨拙的做法。更清晰的方案是在後端返回數據時就把它拼進去,或者用 emptyText 配合 allowBlank: true 表達「不選」的語義。

字段名建議統一大小寫風格。示例中 TEXT / VALUE 全大寫,是為了對應數據庫列名;若後端返回的是駝峰命名的 DTO,前端也應保持一致的駝峰寫法,避免來回映射。

數據量大時(比如上千條選項),不要一次全量加載。可以改用 mode: 'remote' 加 minChars 實現按需搜索,或引入 Ext.ux.form.SearchField 一類的延遲加載組件,顯著改善首屏性能。

最後,這些 API 均屬 ExtJs 3.x/4.x 風格。ExtJs 5 之後推薦使用 ViewModel 與 Ext.data.Store 的 proxy 配置式聲明,語法差異較大,遷移時需要留意。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved