
需求:一個頁面有 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,同樣沒反應。
關鍵在於: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 就生效了。這說明焦點機制確實是癥結,只差「開場時誰持有焦點」。
要讓頁面一載入就能用快捷鍵,就得手動把焦點交給其中一個面板:
Ext.onReady(function () {
// ...viewport 與兩個 KeyMap 同上...
Ext.get('panelB').focus();
});
實測結果:開啟瀏覽器直接按 F2 生效;點擊 A 或 B 後再按 F2 也各自觸發對應的動作,需求達成。
三個層次的問題其實環環相扣:
Ext.util.KeyMap 本身沒問題,它忠實地把按鍵事件綁在指定 target 上。focus() 主動指派。換個角度想,如果同一頁有多組快捷鍵需要「依焦點所在區域分流」,那麼 tabindex 加 focus 就是必做的功課;反之若只是全域單一快捷鍵,直接綁在 document 或 viewport 上會更省事,不必每個面板都處理。