keypress | onkeypress event
Fires when the user presses an alphanumeric key.
![]() |
Syntax
| HTML Attribute | <element onkeypress = "handler(event)"> |
|---|---|
| Event Property | object.onkeypress = handler; |
| attachEvent Method | object.attachEvent("onkeypress", handler) |
| addEventListener Method | object.addEventListener("keypress", handler, useCapture) |
Event information
| Synchronous | No |
|---|---|
| Bubbles | Yes |
| Cancelable | Yes |
Event handler parameters
- pEvtObj [in]
-
Type: IHTMLEventObj
Standards information
- HTML 4.01 Specification, Section 18.2.3
Remarks
As of Microsoft Internet Explorer 4.0, the onkeypress event fires and can be canceled for the following keys:
- Letters: A - Z (uppercase and lowercase)
- Numerals: 0 - 9
- Symbols: ! @ # $ % ^ & * ( ) _ - + = < [ ] { } , . / ? \ | ' ` " ~
- System: ESC, SPACEBAR, ENTER
Returns a number specifying the Unicode value of the key that was pressed.
To invoke this event, do one of the following:
- Press any alphanumeric keyboard key.
Examples
This example shows how to retrieve information from the shiftKeyshiftKey property of the event object. When the user simultaneously presses the shift key and types a character in the first text field, the value "true" appears in the second text field.
Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/onkeypressEX.htm
<head> <script type="text/javascript"> function checkKey() { if (window.event.shiftKey) // checks whether the SHIFT key // is pressed { txtOutput.value = "true"; // returns TRUE if SHIFT is pressed // when the event fires } } </script> </head> <body> <p>Press the SHIFT key while pressing another key.<br> <input type="text" name="txtEnterValue" onkeypress="checkKey()"> </p> <p>Indicates "true" if the shift key is used.<br> <input type="text" name="txtOutput"> </p> </body>
See also
- a
- abbr
- acronym
- address
- applet
- area
- audio
- b
- bdo
- big
- blockQuote
- body
- button
- canvas
- caption
- center
- cite
- code
- custom
- dd
- del
- dfn
- dir
- div
- dl
- document
- dt
- em
- fieldSet
- font
- form
- hn
- hr
- i
- img
- input type=button
- input type=checkbox
- input type=email
- input type=file
- input type=image
- input type=number
- input type=password
- input type=radio
- input type=range
- input type=reset
- input type=search
- input type=submit
- input type=tel
- input type=text
- input type=url
- kbd
- label
- legend
- li
- listing
- map
- marquee
- menu
- nextID
- noBR
- object
- ol
- p
- plainText
- pre
- q
- rt
- ruby
- s
- samp
- select
- small
- source
- span
- strike
- strong
- sub
- sup
- table
- tBody
- td
- textArea
- tFoot
- th
- tHead
- tr
- tt
- u
- ul
- var
- video
- window
- xmp
- Reference
- onchange
- onkeydown
- onkeyup
