Class Ext.KeyMap
|
Package:
|
Ext.grid
|
|
Defined In:
|
.js
|
|
Class:
|
|
|
Extends:
|
Object
|
Ext.KeyMap类负责在某一元素上,键盘和用户动作(Actions)之间的映射。
构建器可接收由#addBinding定义的相同配置项对象。
如果你绑定了一个KeyMap的回调函数,KeyMap会在该回调函数上提供下列参数(String key, Ext.EventObject e)
如果匹配的是组合键,回调函数也只会执行一次)
KepMap能够实现以字符串来表示key
一个key可用于多个动作。
用法:
// 映射key(由keycode指定)
var map = new Ext.KeyMap("my-element", {
key: 13, // 或者是 Ext.EventObject.ENTER
fn: myHandler,
scope: myObject
});
// 映射组合键(由字符串指定)
var map = new Ext.KeyMap("my-element", {
key: "a\r\n\t",
fn: myHandler,
scope: myObject
});
// 映射多个动作的组合键(由字符串和code数组指定)
var map = new Ext.KeyMap("my-element", [
{
key: [10,13],
fn: function(){ alert("Return was pressed"); }
}, {
key: "abc",
fn: function(){ alert('a, b or c was pressed'); }
}, {
key: "\t",
ctrl:true,
shift:true,
fn: function(){ alert('Control + shift + tab was pressed.'); }
}
]);
一个KeyMap开始激活
配置项
这个类没有配置项。
公告属性
|
属性
|
定义者
|
|
|
stopEvent: Boolean
如果让KeyMap来处理key,设置true的话,则停止事件上报(ev...
如果让KeyMap来处理key,设置true的话,则停止事件上报(event from bubbling),并阻拦默认浏览器动作(默认为false)
|
KeyMap
|
公共方法
| |
addBinding
(
Object config
)
新增该KeyMap的新绑定。下列配置项(对象的属性)均被支持:
新增该KeyMap的新绑定。下列配置项(对象的属性)均被支持:
属性 类型 描述
---------- --------------- ----------------------------------------------------------------------
key String/Array 进行处理的单个keycode或keycodes组成的数组
shift Boolean True:只有shift按下的的同时处理key (默认false)
ctrl Boolean True:只有ctrl按下的的同时处理key (默认false)
handler Function 当KeyMap找到预期的组合键时所执行的函数
alt Boolean True:只有alt按下的的同时处理key (默认false)
fn Function 当组合键按下后回调函数
scope Object 回调函数的作用域
用法:
// 创建一个KeyMap
var map = new Ext.KeyMap(document, {
key: Ext.EventObject.ENTER,
fn: handleKey,
scope: this
});
//对现有的KeyMap延迟再绑定
map.addBinding({
key: 'abc',
shift: true,
fn: handleKey,
scope: this
});
参数项:
config : Object
单个KeyMap配置
返回:
|
KeyMap
|
| |
on
(
*/ ,
Function fn,
Object scope
)
加入单个键侦听器的简写方式
{key: (number or arr...
加入单个键侦听器的简写方式
{key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
参数项:
: */
@param {Number/Array/Object} key 既可是key code,也可以是key codes的集合,或者是下列的对象
{key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
fn : Function
调用的函数
scope : Object
(optional) 函数的作用域
返回:
|
KeyMap
|
| |
isEnabled
(
)
: Boolean
|
KeyMap
|
| |
enable
(
)
|
KeyMap
|
| |
disable
(
)
|
KeyMap
|
公告事件
这个类没公共的事件。