使用 jQuery EasyUI 的日期元件時,有一個很常見的困惑:畫面上明明已經選好了日期,用一般方式取值卻拿到空字串。本文記錄這個問題的成因與解法。
假設頁面上有這麼一個日期輸入框:
<input type="text" name="mdate" size="20" id="mdate" class="easyui-datebox" />
使用者透過日期面板選好日期後,直覺地寫:
var dv = $('#mdate').val();
結果卻是空值。更奇怪的是,如果後端在頁面輸出時替這個欄位設了初始值,那麼無論之後再選什麼日期,取到的永遠是那個初始值。
EasyUI 在初始化 datebox 時,會另外建立一個隱藏的 input 元素來保存真正的值,而 .val() 讀到的是原始那個用來顯示文字的欄位。兩者並不是同一份資料,自然對不上。
改用元件本身提供的 API 取值即可:
var dv = $('#mdate').datebox('getValue');
若要設定值,對應的寫法是 $('#mdate').datebox('setValue', '2016-11-09')。需要的話也能用 getText 取得格式化後的顯示文字。
有意思的是,即使 .val() 取不到值,表單送出時名為 mdate 的欄位卻能帶上正確的內容。合理推測是 EasyUI 在送出前同步了隱藏欄位的值。這件事本身就說明了一個道理:當你在操作一個被程式庫包裝過的元件時,應該透過它開放的介面存取狀態,而不是直接對 DOM 下手。
遇到 EasyUI 元件取值不如預期,先別急著懷疑自己的邏輯,回頭查一下該元件是否维护了獨立的內部狀態。datebox、combobox、numberbox、datetimebox 這一類元件都有成對的 getXxx/setValue 方法,養成使用這些方法的習慣,能省下不少排查時間。