react-focus-trap
v2.7.2
Published
Traps focus for accessible dropdowns and modal content.
Downloads
35,761
Readme
A generic focus management tool for components such as dialogs and dropdowns.
Usage
React Focus Trap is a container element that will manage focus for its children.
let Modal = React.createClass({
render() {
return (
<FocusTrap onExit={ this._onExit } active={ this.props.active }>
Amazing stuff goes here
</FocusTrap>
)
}
})
When Focus Trap is active, it will do several things:
- Ensure focus remains on its content
- Exits when clicks outside of the container occur
- Exits when the escape key is pressed
Props
| Name | Default | Description |
| ---------- | --------------------- | ----------------------------------------------------- |
| active | true
| Should the FocusTrap render? |
| className | 'focus-trap'
| The class of the inner container that maintains focus |
| onExit | null
| Callback when escape or an outside click occurs |
| element | 'div'
| The tag name of the inner container |
| role | 'dialog'
| The aria role for the inner container |
Visit code.viget.com to see more projects from Viget.