1.1.6 • Published 4 years ago

@famence/js-keycodes v1.1.6

Weekly downloads
2
License
MIT
Repository
github
Last release
4 years ago

js-keycodes

travis build codecov NPM version Downloads License

Key-Codes as constants and helper functions to identify characters

Installation

NPMYarn
npm i -S @famence/js-keycodesyarn add @famence/js-keycodes

Available Key Codes Constants

import { keyCodes } from '@famence/js-keycodes';

keyCodes.ENTER === 13;
// -> true
keyCodes.F12 === 123;
// -> true

window.addEventListener('keyup', (e) => {
  if (e.keyCode === keyCodes.ENTER) {
    console.log('ENTER was pressed');
  }
});
Constant NameKey Code value
ENTER13
ESC27
BACKSPACE8
TAB9
SHIFT16
CTRL17
ALT18
SPACE32
PAUSE19
PAGE_UP33
PAGE_DOWN34
END35
HOME36
LEFT37
UP38
RIGHT39
DOWN40
INSERT45
DELETE46
F1112
F2113
F3114
F4115
F5116
F6117
F7118
F8119
F9120
F10121
F11122
F12123
DOT190
DOT_NUMPAD110
COMA188
COMA_NUMPAD0
A65
B66
C67
D68
E69
F70
G71
H72
I73
J74
K75
L76
M77
N78
O79
P80
Q81
R82
S83
T84
U85
V86
W87
X88
Y89
Z90
ZERO48
ONE49
TWO50
THREE51
FOUR52
FIVE53
SIX54
SEVEN55
EIGHT56
NINE57
ZERO_NUMPAD96
ONE_NUMPAD97
TWO_NUMPAD98
THREE_NUMPAD99
FOUR_NUMPAD100
FIVE_NUMPAD101
SIX_NUMPAD102
SEVEN_NUMPAD103
EIGHT_NUMPAD104
NINE_NUMPAD105

Helper functions

import * as KeyCodes from '@famence/js-keycodes';

Or individual functions:

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

Verify if a keyCode is a letter

import { isLetter, keyCodeToString } from '@famence/js-keycodes';

window.addEventListener('keyup', (e) => {
  if (isLetter(e.keyCode)) {
    const char = keyCodeToString(e.keyCode);
    console.log(`"${char}" was pressed`);
  }
});

Verify if ENTER is pressed on an event

import { keyCodes } from '@famence/js-keycodes';

const handleAnEvent = (event) => {
  if (event.keyCode === keyCodes.ENTER) {
    // Do your stuff here.
  }
};

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 ⬆️, ⬇️, ⬅️ or ➡️.

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 '@famence/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 '@famence/js-keycodes';

const myLetter = getKeyNameFromKeyCode(90);
// -> 'Z'

const myNumber = getKeyNameFromKeyCode(50);
// -> 'TWO'

const myKey = getKeyNameFromKeyCode(13);
// -> 'ENTER'

const myF = getKeyNameFromKeyCode(121);
// -> 'F10'
1.1.6

4 years ago

1.1.5

4 years ago

1.1.4

4 years ago

1.1.3

4 years ago