CodePlayer

keypress()函数用于为每个匹配元素的keypress事件绑定处理函数。此外，你还可以额外传递给事件处理函数一些数据。

keypress事件会在按下键盘按键时触发。它与keydown事件类似，但keypress着重的是按下该键输入了哪个字符(只有能够打印字符的键才会触发keypress)，keydown着重的是按下了哪个键(按下任何键都可触发keydown)。对于诸如Ctrl、Alt、Shift、Delete、Esc等修饰性和非打印键，请监听keydown事件。

此外，你可以为同一元素多次调用该函数，从而绑定多个事件处理函数。触发keypress事件时，jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。

要删除通过keypress()绑定的事件，请使用unbind()函数。

该函数属于jQuery对象(实例)。

语法

jQueryObject.keypress( [[ data ,]  handler ] )

如果指定了至少一个参数，则表示绑定keypress事件的处理函数；如果没有指定任何参数，则表示触发keypress事件。

参数

jQuery 1.4.3 新增支持：keypress()支持data参数。

参数handler中的this指向当前DOM元素。keypress()还会为handler传入一个参数：表示当前事件的Event对象。

返回值

keypress()函数的返回值为jQuery类型，返回当前jQuery对象本身。

示例&说明

请参考以下HTML示例代码：

<input id="chars" type="text" />

现在，我们为window对象的keypress事件绑定处理函数(可以绑定多个，触发时按照绑定顺序依次执行)：

keypress事件的event.which属性返回的是按键所输入的字符的Unicode值。keydown事件的event.which属性返回的是所按下的键盘按键的映射代码值。

// 检测按键输入的字符
// Ctrl、Alt等非打印键不会触发keypress事件
$(window).keypress( function(event){
	$("body").append( "<br>你输入了字符[" + String.fromCharCode( event.which ) + "](event.which=" + event.which + ')' ) ;
} );

// 触发keypress事件
// $(window).keypress( );

运行代码(以下代码请自行复制到演示页面运行)

我们还可以为事件处理函数传递一些附加的数据。此外，通过jQuery为事件处理函数传入的参数Event对象，我们可以获取当前事件的相关信息(比如事件类型、触发事件的DOM元素、附加数据等)：

// { A:65, Z:90, a:97, z:122 }
var validChars = { "A": "A".charCodeAt(0), "Z": "Z".charCodeAt(0), "a": "a".charCodeAt(0), "z": "z".charCodeAt(0)  };

// 只允许输入大小写字母，不允许输入其他字符(使用某些输入法可能会绕过该限制，从而输入中文或其它字符)
$("#chars").keypress( validChars, function(event){
	var ch = event.data;
	return event.which >= ch.A && event.which <= ch.Z || event.which >= ch.a && event.which <= ch.z;
} );