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
.
This CommonJS module is still in an experimental state, until it reaches v1.0.0 you must consider all minor releases as breaking changes. Patch releases may introduce new features, but will be backwards compatible.
const keyboardTrap = require('makeup-keyboard-trap');
// trap an element
keyboardTrap.trap(document.querySelector('el'));
// untrap the current trapped element
keyboardTrap.untrap();
// via npm
npm install makeup-keyboard-trap
// via yarn
yarn add makeup-keyboard-trap
- keyboardTrap : fired by trapped element when keyboard trap is activated
- keyboardUntrap : fired by trapped element when keyboard trap is deactivated