# a11y-focus-scope

**Repository Path**: mirrors_cloudflare/a11y-focus-scope

## Basic Information

- **Project Name**: a11y-focus-scope
- **Description**: Accessibility util for scoping focus to an element.
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# a11y-focus-scope

> Accessibility util for scoping focus to an element.

## Installation

```sh
$ npm install --save a11y-focus-scope
```

## Usage

```js
import {scopeFocus, unscopeFocus} from 'a11y-focus-scope';

document.body.innerHTML = `
  <button id="outer-button">Outer Button</button>

  <div id="container">
    <button id="inner-button">Inner Button</button>
  </div>
`;

var container = document.getElementById('container');
var innerButton = document.getElementById('inner-button');
var outerButton = document.getElementById('outer-button');

scopeFocus(container);
// document.activeElement === container;

innerButton.focus();
// document.activeElement === innerButton;

outerButton.focus();
// document.activeElement === container;

unscopeFocus();
outerButton.focus();
// document.activeElement === outerButton;
```