forked from paypal/bootstrap-accessibility-plugin
-
Notifications
You must be signed in to change notification settings - Fork 0
/
params.json
1 lines (1 loc) · 3.85 KB
/
params.json
1
{"name":"Bootstrap-accessibility-plugin","tagline":"Accessibility Plugin for Bootstrap 3 and Bootstrap 3 as SubModule","body":"[Bootstrap Accessibility Plugin](http://paypal.github.com/bootstrap-accessibility-plugin) is an extension for the [Bootstrap 3 web development](http://getbootstrap.com/) framework that makes many of the components of this library accessible for keyboard and screen reader users. Today we are launching this plugin on [Github](https://github.com/paypal/bootstrap-accessibility-plugin) under the [BSD license](LICENSE.md). We hope that this extension will make it very simple for website developers who use Bootstrap 3 components to provide great user experience for as many users as possible.\r\n\r\nIf you develop websites or web applications using Bootstrap components and want it to be accessible with a minimal development effort, this accessibility plugin may be the perfect solution. By adding the JavaScript plugin in your Bootstrapped HTML pages, you extend the stock components with an additional mark-up and events without modifying the original Bootstrap code. In doing so, you make those widgets keyboard-navigable and introduce the compatibility with screen reader software used by people who are visually impaired.\r\nFeatures\r\n\r\nThis plugin provides enhancements to the Bootstrap 3 components in two areas: keyboard navigation and ## screen reader compatibility. There are also minor changes to improve color contrast in alert messages.\r\n\r\n\r\n## Keyboard Navigation\r\nFor some widgets, like tab panel, carousel, drop-down menu, etc, the onKeyDown event is employed in various places in order to make the desktop-style keyboard navigation possible. This enables someone who does not or cannot use the mouse navigate those components using tab and arrow keys. To further enhance the seamless navigation for keyboard users the plugin manages keyboard focus wherever appropriate.\r\n\r\n## Compatibility With Screen Readers\r\nOnce the plugin is loaded into your page, it will search for any available Bootstrap components and, if found, append the necessary [ARIA roles and states](http://www.w3.org/TR/wai-aria/) to provide the enhanced semantics to those widgets. This is primarily useful for screen readers. Without ARIA mark-up it is difficult for this technology to express the meaning of dynamic elements, such as modeless alerts, tab panels, popup menus, carousels, etc, to users who cannot see the screen.\r\n\r\n## Color Contrast\r\n\r\nWe found that the foreground-to-background color contrast ratio for a Bootstrap alert message is too low. To make it easier for users to read, the color contrast has been increased.\r\n\r\nPlease see the [README](https://github.com/paypal/bootstrap-accessibility-plugin/blob/master/README.md) file for the list of components and more implementation details.\r\n\r\n\r\n## Try it out\r\n\r\nIf you want to use the Bootstrap Accessibility Plugin in your project, simply include the JavaScript file right after Bootstrap’s JavaScript file. The exact instructions of how to do this can be found in the [README](README.md).\r\n\r\nAlso, play around with the live [demo](demo.html) of the Bootstrap Accessibility Plugin. For better effect, you may want to get hold of one of the [popular screen readers](http://en.wikipedia.org/wiki/List_of_screen_readers) if you would like to immerse yourself into the screen reader user experience. Seeing and hearing how “accessified” widgets work in this demo will help you verify whether the plugin is installed correctly on your website.\r\n\r\nWe look forward to improvements and suggestions from the community. To learn more about how Bootstrap Accessibility Plugin works, check out our [detailed documentation]((README.md).\r\n\r\nTo stay in touch with us, follow @PayPalInclusive and submit issues on GitHub.","google":"","note":"Don't delete this file! It's used internally to help with page regeneration."}