npm.io
9.0.8 • Published 1 year ago

@fluentui/keyboard-keys

Licence
MIT
Version
9.0.8
Deps
1
Size
212 kB
Vulns
0
Weekly
0
Stars
20.2K

@fluentui/keyboard-keys

Contains a set of keyboard constants for key and keyCode comparison in components. This package contains named key values from The w3 uievents-key specification.

Unicode values are not included since there are a lot of locales to consider and they provide no benefit since unicode characters can be used directly in code.

Usage

import { Enter } from '@fluentui/keyboard-keys';

const onKeyDown = (e: React.KeyboardEvent) => {
  if (e.key === Enter) {
    // ...
  }

  // Unicode characters 'a', '1', '%'...
  // should be used directly in code
  if (e.key === 'a') {
    // ...
  }
};

Legacy keyCode

In order to migrate easily from @fluentui/keyboard-key legacy keyCode support is available in this library but is not encouraged for reuse since this propoerty has been deprecated for a while and will be removed in future standards.

import { keyCodes } from '@fluentui/keyboard-keys';

const onKeyDown = (e: React.KeyboardEvent) => {
  if (e.keyCode === keyCodes.Enter) {
    // ...
  }

  if (e.key === keyCodes.a) {
    // ...
  }
};