Skip to content
This repository has been archived by the owner. It is now read-only.
Prevents screen reader's virtual cursor from leaving the confines of an element.
JavaScript
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
.eslintrc
.gitignore
.npmignore
.npmrc
.travis.yml
LICENSE.md
README.md
browser.json
jquery.screenreadertrap.js
jquery.screenreadertrap.min.js
karma.conf.js
package.json
test-data.js
test-setup.js
test.js
yarn.lock

README.md

jquery-screenreader-trap

Build Status Coverage Status Dependency status devDependency status

ATTENTION: A non-jQuery version is now available at makeup-screenreader-trap.

Prevents screen reader's virtual cursor from leaving the confines of a containing element.

Screenreader-trap is a singleton as there can only ever be one active screenreader-trap on a page. Creating a new screenreader-trap will disable the current trap.

$.trapScreenreader($containerEl);
$.untrapScreenreader();

Install

npm install jquery-screenreader-trap

Events

  • screenreaderTrap : fired when screenreader trap is activated
  • screenreaderUntrap : fired when screenreader trap is deactivated

Dependencies

Development

Run npm start for test driven development. All tests are located in test.js.

Execute npm run to view all available CLI scripts:

  • npm start test driven development: watches code and re-tests after any change
  • npm test runs tests & generates reports (see reports section below)
  • npm run lint lints code for syntax and style
  • npm run fix attempts to auto fix style errors
  • npm run minify builds minified version of code
  • npm run jsdoc generates jsdocs
  • npm run build minifies code and generates jsdocs
  • npm run clean deletes all generated files

The following hooks exist, and do not need to be invoked manually:

  • npm prepublish cleans, lints, tests and builds on every npm publish command
  • pre-commit cleans, lints, tests and builds on every git commit command

Test Reports

Each test run will generate the following reports:

  • /test_reports/coverage contains Istanbul code coverage report
  • /test_reports/html contains HTML test report
  • /test_reports/junit contains JUnit test report

JSDocs

JSDocs are generated under ./jsdoc folder.

CI Build

https://travis-ci.org/makeup-jquery/jquery-screenreader-trap

Code Coverage

https://coveralls.io/github/makeup-jquery/jquery-screenreader-trap?branch=master

You can’t perform that action at this time.