js-keycodes

1.1.2 • Public • Published

js-keycodes

travis build codecov NPM version Downloads License

Identify and work with keyCodes on JavaScript

Install

npm i -S js-keycodes

Usage

First import the lib into your code:

import * as KeyCodes from 'js-keycodes';

Or individual functions:

import { isLetter, isNumber } from 'js-keycodes';

Verify if a keyCode is a letter

import { isLetter } from 'js-keycodes';
 
const myKeyCode = 90;
if (isLetter(myKeyCode)) {
  // Do stuff if your keyCode is a letter
}

Verify if ENTER is pressed on an event

import { keyCodes } from 'js-keycodes';
 
const handleAnEvent = (event) => {
  if (event.which === keyCodes.ENTER) {
    // Do your stuff here.
  }
}

Methods

KeyCodes.isNumber()

Return true if the keyCode is a number from 0 to 9.

KeyCodes.isLetter()

Return true if the keyCode is a letter from A to Z.

KeyCodes.isNavigation()

Return true if the keyCode represents an Arrow key like UP, DOWN, LEFT or RIGHT.

KeyCodes.isWhitespace()

Return true if the keyCode represent ENTER, SPACE or TAB

KeyCodes.isF1ToF12()

Return true if the keyCode represent any of the F buttons from F1 to F12

KeyCodes.keyCodeToString()

Return a string representation of the keyCode.

import { keyCodeToString } from 'js-keycodes';
 
const myLetter = keyCodeToString(90);
// -> 'Z'
 
const myNumber = keyCodeToString(50)
//  '2'

KeyCodes.getKeyNameFromKeyCode()

Return a string representation based on the programmatic name of the keyCode

import { getKeyNameFromKeyCode } from 'js-keycodes';
 
const myLetter = getKeyNameFromKeyCode(90);
// -> 'Z'
 
const myNumber = getKeyNameFromKeyCode(50);
// -> 'TWO'
 
const myKey = getKeyNameFromKeyCode(13);
// -> 'ENTER'
 
const myF = getKeyNameFromKeyCode(121);
// -> 'F10'

Available Key Codes

Usage

import { keyCodes } from 'js-keycodes';
 
keyCodes.ENTER === 13;
// -> true
keyCodes.F12 === 123;
// -> true
 
// Using with JQuery
$.click((event) => {
  if (event.keyCode === keyCodes.F1) {
    // do an amazing think!
  }
});
Key Name Key Code
ENTER 13
ESC 27
BACKSPACE 8
TAB 9
SHIFT 16
CTRL 17
ALT 18
SPACE 32
PAUSE 19
PAGE_UP 33
PAGE_DOWN 34
END 35
HOME 36
LEFT 37
UP 38
RIGHT 39
DOWN 40
INSERT 45
DELETE 46
F1 112
F2 113
F3 114
F4 115
F5 116
F6 117
F7 118
F8 119
F9 120
F10 121
F11 122
F12 123
DOT 190
DOT_NUMPAD 110
COMA 188
COMA_NUMPAD 0
A 65
B 66
C 67
D 68
E 69
F 70
G 71
H 72
I 73
J 74
K 75
L 76
M 77
N 78
O 79
P 80
Q 81
R 82
S 83
T 84
U 85
V 86
W 87
X 88
Y 89
Z 90
ZERO 48
ONE 49
TWO 50
THREE 51
FOUR 52
FIVE 53
SIX 54
SEVEN 55
EIGHT 56
NINE 57

Package Sidebar

Install

npm i js-keycodes

Weekly Downloads

4

Version

1.1.2

License

MIT

Unpacked Size

12.6 kB

Total Files

5

Last publish

Collaborators

  • carlos.algms