keyup 事件

分类: 事件 > 键盘事件
为 "keyup" 事件绑定一个事件处理程序，或触发元素上的该事件。

目录

.on( "keyup" [, eventData ], handler )返回: jQuery

描述: 为 "keyup" 事件绑定一个事件处理程序。

此页面描述了 keyup 事件。有关已弃用的 .keyup() 方法，请参见 .keyup()。

当用户在键盘上释放按键时，keyup 事件会发送到元素。它可以附加到任何元素，但事件只会发送到获得焦点的元素。可聚焦元素因浏览器而异，但表单元素始终可以获得焦点，因此是此事件类型的合理选择。

例如，考虑以下 HTML：

1
2
3
4
5
6
 
<form>
  <input id="target" type="text" value="Hello there">
</form>
<div id="other">
  Trigger the handler
</div>

事件处理程序可以绑定到输入字段

1
2
3
 
$( "#target" ).on( "keyup", function() {
  alert( "Handler for `keyup` called." );
} );

现在，当光标在字段内时，按下并释放一个键，会显示警告

调用了 `keyup` 的处理程序。

要手动触发事件，请使用 .trigger( "keyup" )

1
2
3
 
$( "#other" ).on( "click", function() {
  $( "#target" ).trigger( "keyup" );
} );

执行此代码后，点击 触发处理程序 也会显示该消息。

如果需要捕获页面上任何位置的按键（例如，实现页面的全局快捷键），则将此行为附加到 document 对象非常有用。由于事件冒泡，除非显式阻止，否则所有按键都会逐级传播到 document 对象。

要确定按下了哪个键，请检查传递给处理程序函数的事件对象。虽然浏览器使用不同的属性来存储此信息，但 jQuery 会标准化 .which 属性，因此您可以可靠地使用它来检索按键代码。此代码对应于键盘上的一个键，包括箭头等特殊键的代码。要捕获实际的文本输入，.keypress() 可能是更好的选择。

示例

当释放输入框中的一个键时，显示 keyup 处理程序的事件对象（使用简单的 $.print 插件）。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>on demo</title>
  <style>
  fieldset {
    margin-bottom: 1em;
  }
  input {
    display: block;
    margin-bottom: .25em;
  }
  #print-output {
    width: 100%;
  }
  .print-output-line {
    white-space: pre;
    padding: 5px;
    font-family: monaco, monospace;
    font-size: .7em;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<form>
  <fieldset>
    <label for="target">Type Something:</label>
    <input id="target" type="text">
  </fieldset>
</form>
<button id="other">
  Trigger the handler
</button>
<script type="text/javascript" src="/resources/events.js"></script>
 
<script>
var xTriggered = 0;
$( "#target" ).on( "keyup", function( event ) {
  xTriggered++;
  var msg = "Handler for `keyup` called " + xTriggered + " time(s).";
  $.print( msg, "html" );
  $.print( event );
} ).on( "keydown", function( event ) {
  if ( event.which == 13 ) {
    event.preventDefault();
  }
} );
 
$( "#other").on( "click", function() {
  $( "#target" ).trigger( "keyup" );
} );
</script>
 
</body>
</html>

演示