npm.io
0.6.0 • Published 6 months ago

makeup-keyboard-trap

Licence
MIT
Version
0.6.0
Deps
1
Size
12 kB
Vulns
0
Weekly
0
Stars
47

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 { trap, untrap } from "makeup-keyboard-trap";

// trap an element
trap(document.querySelector("el"));

// untrap the current trapped element
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

Keywords