萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

EasyUI DataGrid 鍵盤上下鍵選中行擴充套件實作

為 EasyUI DataGrid 新增鍵盤導航:實作 keyCtr 方法實現上下鍵選中行

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'); // 啟用鍵盤導航

核心邏輯解析

  1. 焦點管理:DataGrid 面板預設不可聚焦,需設定 tabindex=1 並綁定 keydown 事件於面板最外層 .panel 元素。
  2. 鍵碼判斷:38 = Up,40 = Down。
  3. 取得當前選中行索引:getSelected() → getRowIndex()。
  4. 邊界處理:
    • Up 鍵在第一行時 → 選中最後一行(循環)。
    • Down 鍵在最後一行時 → 選中第一行(循環)。
    • 無選中行時:Up → 最後一行,Down → 第一行。
  5. 選中行 API:selectRow(index) 會自動處理視覺高亮與 onSelect 事件觸發。

進階擴充建議

  • PageUp/PageDown:翻頁選中(case 33/34)。
  • Home/End:跳至首/尾行。
  • Enter/Space:觸發編輯或詳細檢視。
  • 焦點視覺化:配合 CSS .datagrid-row-selected { outline: 2px solid #007bff; } 強化鍵盤焦點可見度,符合無障礙規範。

注意事項

  1. 若頁面有多個 DataGrid,各自呼叫 keyCtr() 互不干擾。
  2. 若 DataGrid 重新載入資料(loadData/reload),選中狀態會重置,需在 onLoadSuccess 中恢復焦點。
  3. IE8 以下需確保 jQuery 版本相容(建議 jQuery 1.11.x + EasyUI 1.4+)。

將此擴充套件納入專案通用 JS 庫,即可為所有 DataGrid 快速新增專業級鍵盤導航體驗。

copyright © 萬盛學電腦網 all rights reserved