Source: jquery.focusable.js

  1. /**
  2.  * @file Gets all focusable descendant elements for the first element in the set of matched elements
  3.  * @author Ian McBurnie <ianmcburnie@hotmail.com>
  4.  * @version 1.0.1
  5.  * @requires jquery
  6.  */
  7. (function($, window, document, undefined) { // eslint-disable-line no-unused-vars
  8.     var pluginName = 'jquery-focusable'; // eslint-disable-line no-unused-vars
  10.     var focusableElementsList = [
  11.         'a[href]',
  12.         'button:not([disabled])',
  13.         'area[href]',
  14.         'input:not([disabled])',
  15.         'select:not([disabled])',
  16.         'textarea:not([disabled])',
  17.         'iframe',
  18.         'object',
  19.         'embed',
  20.         '*[tabindex]',
  21.         '*[contenteditable]'
  22.     ];
  24.     var focusableElementsSelector = focusableElementsList.join();
  26.     var defaults = {
  27.         findNegativeTabindex: true,
  28.         findPositiveTabindex: true
  29.     };
  31.     /**
  32.     * jQuery collection plugin that implements aria-activedescendant keyboard navigation on given widgets
  33.     *
  34.     * @method "jQuery.fn.focusable"
  35.     * @param {Object} options options
  36.     * @param {boolean} options.findNegativeTabindex - will return elements with tabindex equal to -1 by default
  37.     * @param {boolean} options.findPositiveTabindex - will return elements with tabindex greater than 0 by default
  38.     * @return {jQuery} chainable jQuery class
  39.     */
  40.     $.fn.focusable = function focusable(options) {
  41.         var opts = $.extend({}, defaults, options);
  43.         return $(this).first().find(focusableElementsSelector)
  44.             .filter(function() {
  45.                 // if findNegativeTabindex option is truthy, immediately return the element.
  46.                 // otherwise only return the element if tabindex is not negative
  47.                 return opts.findNegativeTabindex || ($(this).attr('tabindex') !== '-1');
  48.             })
  49.             .filter(function() {
  50.                 // if findPositiveTabindex option is truthy, immediately return the element.
  51.                 // otherwise only return the element if tabindex is not positive
  52.                 return opts.findPositiveTabindex || ($(this).attr('tabindex') > 0 === false);
  53.             });
  54.     };
  55. }(jQuery, window, document));
  57. /**
  58. * The jQuery plugin namespace.
  59. * @external "jQuery.fn"
  60. * @see {@link http://learn.jquery.com/plugins/|jQuery Plugins}
  61. */