CodePlayer

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

keyup事件会在按下键盘按键并释放时触发。例如：你一直按住A键，直到10秒钟后才释放，只会在释放按键的时候触发一次keyup事件。但在这个过程中会触发许多次keydown事件(或keypress事件)。因此，keyup事件无法阻止字符的输入。

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

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

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

语法

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

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

参数

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

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

返回值

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

示例&说明

请参考以下HTML示例代码：

<input id="keys" type="text" />
<div id="counter">你按了0个键!</div>

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

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

$(window).keyup( function(event){
	$("body").append( "<br>你按下并释放的按键的代码值为:[" + event.which + ']' ) ;
} );


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

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

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

var template = "你按了count个按键!";

// 只允许按下的字母键生效 (使用某些输入法可能会绕过该限制)
$("#keys").keyup( template, function(event){
	var $me = $(this);
	var count = $me.data("count") || 0;
	$me.data("count", ++count);
	$("#counter").html( event.data.replace("count", count) );
} );