EasyUI DataGrid 預設僅支援滑鼠點擊選中行,若需鍵盤上下鍵快速切換選中行(類似 Excel/試算表體驗),需自行擴充元件方法。本文提供一個可直接複用的 keyCtr 擴充套件,並解析核心邏輯。
$.extend($.fn.datagrid.methods, {
keyCtr: function (jq) {
return jq.each(function () {
var grid = $(this);
// 讓面板可獲取焦點,並綁定 keydown 事件
grid.datagrid('getPanel')
.panel('panel')
.attr('tabindex', 1)
.bind('keydown', function (e) {
switch (e.keyCode) {
case 38: // Up 鍵
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: // Down 鍵
var selected = grid.datagrid('getSelected');
if (selected) {
var index = grid.datagrid('getRowIndex', selected);
grid.datagrid('selectRow', index + 1);
} else {
// 無選中行時,選中第一行
grid.datagrid('selectRow', 0);
}
break;
}
});
});
}
});
// DataGrid 初始化後呼叫
$('#dg').datagrid({
// ... 其他設定
}).datagrid('keyCtr'); // 啟用鍵盤導航
tabindex=1 並綁定 keydown 事件於面板最外層 .panel 元素。38 = Up,40 = Down。getSelected() → getRowIndex()。selectRow(index) 會自動處理視覺高亮與 onSelect 事件觸發。case 33/34)。.datagrid-row-selected { outline: 2px solid #007bff; } 強化鍵盤焦點可見度,符合無障礙規範。keyCtr() 互不干擾。loadData/reload),選中狀態會重置,需在 onLoadSuccess 中恢復焦點。將此擴充套件納入專案通用 JS 庫,即可為所有 DataGrid 快速新增專業級鍵盤導航體驗。