.keypress()

要素のkeypressイベントにbindします。また、keypressイベントを実行します。

このメソッドは、1つ目と2つ目は.bind('keypress', handler)への、3つ目は.trigger('keypress')への ショートカットです。

keypressはユーザーがキーを押した際に要素にイベントが通知されます。

.keypress( handler(eventObject) ) 1.0追加

戻り値:jQuery

要素のkeypressイベントにbindします。また、keypressイベントを実行します。

引数 説明
handler(eventObject) イベントが発生した際に、実行したい処理を関数として指定します。

.keypress( [eventData], handler(eventObject) ) 1.4.3追加

戻り値:jQuery

要素のkeypressイベントにbindします。また、keypressイベントを実行します。

引数 説明
[eventData] マップ値を指定することで、データをイベントハンドラーに渡すことが出来ます。
handler(eventObject) イベントが発生した際に、実行したい処理を関数として指定します。

.keypress() 1.0追加

戻り値:jQuery

keypressイベントを発生させます。

//ID:other要素をクリックすると、ID:targetのキーダウンイベントを実行します。
$('#other').click(function() {
  $('#target').keypress();
});

サンプル

<!DOCTYPE html>
<html>
<head>
<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="http://code.jquery.com/jquery-latest.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="/scripts/events.js"></script>
<script>
var xTriggered = 0;
$('#target').keypress(function(event) {
  if (event.which == 13) {
     event.preventDefault();
   }
   xTriggered++;
   var msg = 'Handler for .keypress() called ' + xTriggered + ' time(s).';
  $.print(msg, 'html');
  $.print(event);
});
$('#other').click(function() {
  $('#target').keypress();
});
</script>
</body>
</html>

 Back to top

© 2010 - 2017 STUDIO KINGDOM