interactive-supports-focus.js 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110
  1. "use strict";
  2. var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
  3. Object.defineProperty(exports, "__esModule", {
  4. value: true
  5. });
  6. exports["default"] = void 0;
  7. var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
  8. var _ariaQuery = require("aria-query");
  9. var _jsxAstUtils = require("jsx-ast-utils");
  10. var _arrayIncludes = _interopRequireDefault(require("array-includes"));
  11. var _schemas = require("../util/schemas");
  12. var _getElementType = _interopRequireDefault(require("../util/getElementType"));
  13. var _isDisabledElement = _interopRequireDefault(require("../util/isDisabledElement"));
  14. var _isHiddenFromScreenReader = _interopRequireDefault(require("../util/isHiddenFromScreenReader"));
  15. var _isInteractiveElement = _interopRequireDefault(require("../util/isInteractiveElement"));
  16. var _isInteractiveRole = _interopRequireDefault(require("../util/isInteractiveRole"));
  17. var _isNonInteractiveElement = _interopRequireDefault(require("../util/isNonInteractiveElement"));
  18. var _isNonInteractiveRole = _interopRequireDefault(require("../util/isNonInteractiveRole"));
  19. var _isPresentationRole = _interopRequireDefault(require("../util/isPresentationRole"));
  20. var _getTabIndex = _interopRequireDefault(require("../util/getTabIndex"));
  21. /**
  22. * @fileoverview Enforce that elements with onClick handlers must be tabbable.
  23. * @author Ethan Cohen
  24. *
  25. */
  26. // ----------------------------------------------------------------------------
  27. // Rule Definition
  28. // ----------------------------------------------------------------------------
  29. var schema = (0, _schemas.generateObjSchema)({
  30. tabbable: (0, _schemas.enumArraySchema)((0, _toConsumableArray2["default"])(_ariaQuery.roles.keys()).filter(function (name) {
  31. return !_ariaQuery.roles.get(name)["abstract"];
  32. }).filter(function (name) {
  33. return _ariaQuery.roles.get(name).superClass.some(function (klasses) {
  34. return (0, _arrayIncludes["default"])(klasses, 'widget');
  35. });
  36. }))
  37. });
  38. var domElements = (0, _toConsumableArray2["default"])(_ariaQuery.dom.keys());
  39. var interactiveProps = [].concat(_jsxAstUtils.eventHandlersByType.mouse, _jsxAstUtils.eventHandlersByType.keyboard);
  40. var _default = {
  41. meta: {
  42. docs: {
  43. url: 'https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/tree/HEAD/docs/rules/interactive-supports-focus.md',
  44. description: 'Enforce that elements with interactive handlers like `onClick` must be focusable.'
  45. },
  46. schema: [schema]
  47. },
  48. create: function create(context) {
  49. var elementType = (0, _getElementType["default"])(context);
  50. return {
  51. JSXOpeningElement: function JSXOpeningElement(node) {
  52. var tabbable = context.options && context.options[0] && context.options[0].tabbable || [];
  53. var attributes = node.attributes;
  54. var type = elementType(node);
  55. var hasInteractiveProps = (0, _jsxAstUtils.hasAnyProp)(attributes, interactiveProps);
  56. var hasTabindex = (0, _getTabIndex["default"])((0, _jsxAstUtils.getProp)(attributes, 'tabIndex')) !== undefined;
  57. if (!(0, _arrayIncludes["default"])(domElements, type)) {
  58. // Do not test higher level JSX components, as we do not know what
  59. // low-level DOM element this maps to.
  60. return;
  61. }
  62. if (!hasInteractiveProps || (0, _isDisabledElement["default"])(attributes) || (0, _isHiddenFromScreenReader["default"])(type, attributes) || (0, _isPresentationRole["default"])(type, attributes)) {
  63. // Presentation is an intentional signal from the author that this
  64. // element is not meant to be perceivable. For example, a click screen
  65. // to close a dialog .
  66. return;
  67. }
  68. if (hasInteractiveProps && (0, _isInteractiveRole["default"])(type, attributes) && !(0, _isInteractiveElement["default"])(type, attributes) && !(0, _isNonInteractiveElement["default"])(type, attributes) && !(0, _isNonInteractiveRole["default"])(type, attributes) && !hasTabindex) {
  69. var role = (0, _jsxAstUtils.getLiteralPropValue)((0, _jsxAstUtils.getProp)(attributes, 'role'));
  70. if ((0, _arrayIncludes["default"])(tabbable, role)) {
  71. // Always tabbable, tabIndex = 0
  72. context.report({
  73. node,
  74. message: "Elements with the '".concat(role, "' interactive role must be tabbable.")
  75. });
  76. } else {
  77. // Focusable, tabIndex = -1 or 0
  78. context.report({
  79. node,
  80. message: "Elements with the '".concat(role, "' interactive role must be focusable.")
  81. });
  82. }
  83. }
  84. }
  85. };
  86. }
  87. };
  88. exports["default"] = _default;
  89. module.exports = exports.default;