用 EasyUI 的 combobox 做「編輯時回填已選項」,很常遇到一個惱人的現象:明明值對得上,下拉框卻停在空白或自動跳到第一項。原因通常不是設定寫錯,而是型別不一致。
combobox 必須先有 data 才能匹配。若在 onLoadSuccess 之前就 setValue,比對時選項清單還是空的,自然對不上。因此回填動作要放在 onLoadSuccess 回呼中。
<tr>
<td style="text-align: right;">院系:</td>
<td>
<input type="hidden" id="belongsvalue" value="${fbook.belongs}" />
<!-- 這裡的值必須是整數型別的資料,否則下拉框會自動選定其他項 -->
</td>
<td><input name="belongs" id="belongs"></input></td>
</tr>
用一個隱藏欄位暫存後端傳來的原值,是為了避免在 JS 中直接從伺服器端運算式取值,讓資料流更清楚。
$('#belongs').combobox({
url : 'opr/book/combobox.do',
valueField : 'id',
textField : 'name',
width : '140',
height : '29',
editable : false,
panelHeight: 'auto',
onLoadSuccess: function (data) {
var b1 = $('#belongsvalue').val(); // 後端傳來的 id
$('#belongs').combobox('setValue', b1); // 這裡才回填
}
});
valueField 對應的 id 在 JSON 中是數字 3,而從 input.value 或 attr() 取出的永遠是字串 "3"。combobox 內部以嚴格相等比對時,3 !== "3",比對失敗,於是它放棄回填並依預設行為選中第一項——這就是「值明明一樣卻選不中」的真相。
三種解法,任選其一並在專案內保持一致:
// 1. 後端明確回傳字串
{"id": "3", "name": "資訊工程系"}
// 2. 前端設定時轉型
$('#belongs').combobox('setValue', Number(b1));
// 3. 前端設定時轉字串(當 valueField 本身是字串時)
$('#belongs').combobox('setValue', String(b1));
editable: false。combobox 預設可以在輸入框打字做搜尋。若這個欄位不該讓使用者手打,記得關掉,否則可能送出選單裡不存在的值。
value 對不上時的預設行為。有些版本的 EasyUI 在找不到匹配項時會顯示空白,有些會選中第一項。與其依賴版本差異,不如在 onLoadSuccess 中先判斷值是否有效,找不到時明確處理(例如顯示提示或清空必填標記)。
用 loadFilter 統一整理資料。若後端回傳的欄位名與 valueField/textField 不一致,用 loadFilter 做一次轉換,比在前端各處散落的取值點做型別轉換更好維護:
loadFilter: function (rows) {
return rows.map(function (r) {
return { id: String(r.id), name: r.name };
});
}
總結一句:combobox 回填失敗,先檢查型別,再檢查時序。這兩點排除後,九成的問題都會消失。