makeup-keyboard-trap
DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/makeup-keyboard-trap package

0.4.1 • Public • Published

makeup-keyboard-trap

This module restricts keyboard tabindex to a single subtree in the DOM. This behaviour is useful when implementing a modal interface (e.g. a modal dialog).

It will ignore programmatically focusable items with a tabindex of -1.

Experimental

This module is still in an experimental state, until it reaches v1 you must consider all minor releases as breaking changes.

import * as keyboardTrap from 'makeup-keyboard-trap';

// trap an element
keyboardTrap.trap(document.querySelector('el'));

// untrap the current trapped element
keyboardTrap.untrap();

Install

// via npm
npm install makeup-keyboard-trap

// via yarn
yarn add makeup-keyboard-trap

Events

  • keyboardTrap : fired by trapped element when keyboard trap is activated
  • keyboardUntrap : fired by trapped element when keyboard trap is deactivated

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 0.4.1
    183
    • latest

Version History

Package Sidebar

Install

npm i makeup-keyboard-trap

Weekly Downloads

210

Version

0.4.1

License

MIT

Unpacked Size

10.2 kB

Total Files

6

Last publish

Collaborators

  • ianmcburnie
  • gardneraustin