用 EasyUI datagrid 做可編輯表格時,有個很常被要求的小細節:點擊某一列,編輯框要立刻開啟,而且游標必須已經在裡面,讓使用者可以埋頭打字。做法是在 onClickRow 中取得 editor 並呼叫 focus。
onClickRow: function (rowIndex, rowData) {
var editor = $('#datagrid').datagrid('getEditor',
{ index: rowIndex, field: "buyNum" });
editor.target.focus();
}
rowIndex 是該列在「目前頁」中的索引,從 0 開始計。這裡有個容易踩到的坑:在分頁或排序之後,rowIndex 指的是畫面上的第幾列,不等於資料集裡的第幾筆。若你需要資料本身的識別,該用 rowData 中的唯一 id,而不是 rowIndex。
field: "buyNum" 指定要開啟編輯的欄位名稱。同一列若有多個可編輯欄位,getEditor 會依 field 找到對應的那一個。
editor.target 是 editor 物件中指向實際輸入元素(input、numberbox 等)的屬性。focus() 必須呼叫在它身上,游標才會真的進去。
EasyUI 進入編輯模式時,預設只會「渲染出輸入框」,但不會自動聚焦。少了這一行,使用者點完還要再點一次才能開始打字,操作上多了一次多餘的動作。這類細節在長時間重複輸入的場景(如出貨單、盤點表)會被放大成明顯的體驗落差。
先確認是否真的進入編輯狀態。若該 datagrid 尚未呼叫 datagrid('beginEdit', ...) 或沒有設定 editor 相關欄位,getEditor 會回傳 null,此時 editor.target.focus() 會直接拋出錯誤。安全寫法:
onClickRow: function (rowIndex, rowData) {
var editor = $('#datagrid').datagrid('getEditor',
{ index: rowIndex, field: "buyNum" });
if (editor) editor.target.focus();
}
與 beginEdit 搭配。若你希望點擊時自動進入編輯模式,順序必須是「先 beginEdit、再 focus」:
onClickRow: function (rowIndex, rowData) {
$('#datagrid').datagrid('selectRow', rowIndex);
$('#datagrid').datagrid('beginEdit', rowIndex);
var editor = $('#datagrid').datagrid('getEditor',
{ index: rowIndex, field: "buyNum" });
if (editor) editor.target.focus();
}
numberbox 之類的複合元件。若欄位型別是 numberbox、combobox、datebox,target 指向的仍是底層 input,focus 通常有效;但部分版本需要改用元件自己的 focus() 方法才能正確觸發。遇到時可先檢查 editor.target 實際是什麼,再決定呼叫方式。
這類「少一次點擊」的優化看似微小,但在資料密集的後台系統中,累積起來就是操作效率的分水嶺。