DIV CSS 佈局教程網

ExtJS 4.1 面板快捷鍵失效?tabindex 與 focus 的三次嘗試
編輯:關於JavaScript     

需求:一個頁面有 A、B 兩個面板,各自都有一顆「添加(F2)」按鈕,希望按 F2 時觸發目前所在面板的動作。聽起來很簡單,ExtJS 提供了 Ext.util.KeyMap 專門做這件事,但實際跑起來卻一路踩坑。

第一次嘗試:直覺寫法,完全沒反應

Ext.onReady(function () {
    var viewport = Ext.create('Ext.container.Viewport', {
        layout: { type: 'vbox', align: 'stretch' },
        padding: 10,
        items: [{
            xtype: 'panel',
            id: 'panelA',
            title: '快捷鍵測試A',
            tbar: [{ text: '添加(F2)' }],
            frame: true, flex: 1,
            html: '您好,這裡顯示的表格或表單。'
        }, {
            xtype: 'panel',
            id: 'panelB',
            title: '快捷鍵測試B',
            tbar: [{ text: '添加(F2)' }],
            frame: true, flex: 1,
            html: '您好,這裡顯示的表格或表單。'
        }]
    });

    Ext.create('Ext.util.KeyMap', {
        target: 'panelA',
        key: Ext.EventObject.F2,
        fn: function (key, ev) {
            alert('添加A');
            ev.stopEvent();
            return false;
        }
    });

    Ext.create('Ext.util.KeyMap', {
        target: 'panelB',
        key: Ext.EventObject.F2,
        fn: function (key, ev) {
            alert('添加B');
            ev.stopEvent();
            return false;
        }
    });
});

實測結果:開啟瀏覽器直接按 F2 沒反應;先用滑鼠點一下 A 或 B 再按 F2,同樣沒反應。

第二次嘗試:加上 tabindex

關鍵在於:KeyMap 綁的是 DOM 層的按鍵事件,而 div 元素預設無法接收焦點,自然收不到鍵盤事件。解法是用 autoEl 明確指定渲染成 div 並給它 tabindex:

xtype: 'panel',
id: 'panelA',
title: '快捷鍵測試A',
tbar: [{ text: '添加(F2)' }],
frame: true, flex: 1,
html: '您好,這裡顯示的表格或表單。',
autoEl {
    tag: 'div',
    tabindex: 0
}

panelB 也照樣加上同樣的 autoEl 設定,KeyMap 部分不變。

實測結果:直接按 F2 還是沒反應,但用滑鼠點一下 A 或 B 之後再按 F2 就生效了。這說明焦點機制確實是癥結,只差「開場時誰持有焦點」。

第三次嘗試:主動呼叫 focus()

要讓頁面一載入就能用快捷鍵,就得手動把焦點交給其中一個面板:

Ext.onReady(function () {
    // ...viewport 與兩個 KeyMap 同上...

    Ext.get('panelB').focus();
});

實測結果:開啟瀏覽器直接按 F2 生效;點擊 A 或 B 後再按 F2 也各自觸發對應的動作,需求達成。

整理一下這次的收穫

三個層次的問題其實環環相扣:

  1. Ext.util.KeyMap 本身沒問題,它忠實地把按鍵事件綁在指定 target 上。
  2. 但 target 對應的 DOM 元素若無法取得焦點(div 沒有 tabindex),鍵盤事件根本不會往下傳,這是最容易被忽略的一環。
  3. 即使元素可以拿焦點,頁面初始狀態預設焦點在 body 上,所以還需要一次 focus() 主動指派。

換個角度想,如果同一頁有多組快捷鍵需要「依焦點所在區域分流」,那麼 tabindex 加 focus 就是必做的功課;反之若只是全域單一快捷鍵,直接綁在 document 或 viewport 上會更省事,不必每個面板都處理。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved