DIV CSS 佈局教程網

easyui datagrid 擴充鍵盤上下鍵切換選取行
編輯:JQuery特效代碼     

資料表格若能支援鍵盤操作,對重度使用者來說效率提升很明顯。做法是為 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) 讓表格自動捲動。
  • 避免與輸入框衝突:若列內有可編輯欄位,方向鍵會互相搶事件,需先判斷焦點來源。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved