用 ExtJS 的 datefield 時,同一個欄位取值竟然有兩種結果,很多人第一次都會愣一下。差別其實一句話講得完:getValue() 給你的是「值」,getRawValue() 給你的是「畫面上看到的那串字」。
{
xtype: 'datefield',
width: 100,
id: 'mydate',
format: 'Y-m-d',
value: new Date(),
msgTarget: 'side',
emptyText: '請選擇日期……',
name: 'mydate'
}
Wed Mar 07 2007 00:00:00 GMT+0100。2007-03-07。若控制項有定義 format,就回傳符合該格式的字串。getValue() 拿到 Date 物件後,可以用欄位自帶的格式化方法轉字串:
mydate.formatDate(mydate.getValue()); // "2007-03-07"
要送進後端或做運算,用 getValue()。它是真正的資料型別,日期可以比較大小、可以做加減,數字欄位可以參與計算。
要顯示給使用者、或做字串比對,用 getRawValue()。它已經套上格式,直接塞進畫面即可。
把兩者搞混的典型症狀是:日期存進資料庫變成 1970 或空值(其實是拿到了物件卻當字串處理),或是字串相減得到 NaN(拿顯示字串去算)。另外要注意 rawValue 是「未經校驗」的原始輸入,如果使用者還沒輸入任何東西,它可能是 emptyText 顯示的那串提示文字,而不是空字串——判空時最好用 getValue() 來判。
這個命名慣例在整個 ExtJS 元件家族裡是一致的:textfield 的 getValue() 回傳字串(因為它的值本來就是字串),numberfield 的 getValue() 回傳數字,datefield 回傳 Date。理解「raw = 畫面上的樣子,value = 真正的資料」這條規則,其他元件就不用逐一查了。