DIV CSS 佈局教程網

Ext 下拉選單 ComboBox 的 store 資料格式怎麼寫
編輯:關於JavaScript     

在 Ext 的表單體系裡,ComboBox 幾乎是必不可少的一個元件。很多剛接觸 Ext 的朋友在寫下拉選單時,最容易卡住的地方就是 store 的資料格式——到底該傳二維陣列、一維陣列,還是走 JsonStore?本文就把這幾種常見寫法一次講清楚。

一、最直觀的兩種寫法

下面的程式碼展示了一個「統計年份」下拉選單,其中註解掉了兩種不同的 store 寫法:

var p_years = new Ext.form.ComboBox({
    fieldLabel : '統計年份',
    anchor : anchor_w,
    mode : 'remote',
    maxHeight : 100,
    triggerAction : 'all',
    selectOnFocus : true,
    forceSelection : true,
    editable : false,
    // 第一種寫法:二維陣列
    // store : [['11', '2011'], ['12', '2012'], ['13', '2013']]
    // 第二種寫法:一維陣列
    store : [2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018]
});

兩者的差別在於:

  • 二維陣列 [['value', 'Text'], ...]:每一筆資料都是一組「值 + 顯示文字」。前者是真正提交到後端的 value,後者是使用者在頁面上看到的文字。
  • 一維陣列 [2011, 2012, ...]:當你沒有明確指定 valueField 與 displayField 時,Ext 會把同一個值同時當成提交值與顯示值。也就是說,看到什麼就送出什麼。

如果只是幾個固定選項,直接手寫陣列是最省事的做法。

二、正規做法:從資料庫同步資料字典

但在真實專案裡,選項通常來自資料表或資料字典,這時候就該改用 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
});

幾個容易忽略的設定

mode: 'remote' 表示資料來自遠端;若資料是本地陣列,應改為 'local'。triggerAction: 'all' 讓點擊時顯示全部選項而不是只篩選符合輸入的項目。editable: false 禁止手動輸入,搭配 forceSelection: true 可以確保使用者只能從清單中挑選,避免送出髒資料。

至於「全部」這一類空值選項,透過監聽 store 的 load 事件再 insert 一筆記錄,是最乾淨的做法——不必改動後端回傳的資料,前端就能靈活補上預設值。

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