資料表格若能支援鍵盤操作,對重度使用者來說效率提升很明顯。做法是為 datagrid 擴充一個名為 keyCtr 的方法,讓面板取得焦點後監聽 keydown,以方向鍵上下移動選取列。
$.extend($.fn.datagrid.methods, {
keyCtr : function (jq) {
return jq.each(function () {
var grid = $(this);
grid.datagrid('getPanel').panel('panel').attr('tabindex', 1).bind('keydown', function (e) {
switch (e.keyCode) {
case 38: // 上
var selected = grid.datagrid('getSelected');
if (selected) {
var index = grid.datagrid('getRowIndex', selected);
grid.datagrid('selectRow', index - 1);
} else {
var rows = grid.datagrid('getRows');
grid.datagrid('selectRow', rows.length - 1);
}
break;
case 40: // 下
var selected = grid.datagrid('getSelected');
if (selected) {
var index = grid.datagrid('getRowIndex', selected);
grid.datagrid('selectRow', index + 1);
} else {
grid.datagrid('selectRow', 0);
}
break;
}
});
});
}
});
$('#dg').datagrid({ /* 你的既有設定 */ });
$('#dg').datagrid('keyCtr');
tabindex 是關鍵。一般 div 元素預設無法取得鍵盤焦點,必須加上 tabindex 才能接收 keydown 事件,這也是為什麼程式碼中要先 attr('tabindex', 1)。
另外,getSelected 在沒有選取列時會回傳 null,因此程式碼做了分支處理:未選取時,按上鍵跳到最後一列、按下鍵跳到第一列,這個設計讓首次使用方向鍵就有合理的起點。
index - 1 可能變成 -1,index + 1 可能超出列數,建議加上範圍判斷。scrollTo(index) 讓表格自動捲動。