role-has-required-aria-props.js 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103
  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 _schemas = require("../util/schemas");
  11. var _getElementType = _interopRequireDefault(require("../util/getElementType"));
  12. var _isSemanticRoleElement = _interopRequireDefault(require("../util/isSemanticRoleElement"));
  13. /**
  14. * @fileoverview Enforce that elements with ARIA roles must
  15. * have all required attributes for that role.
  16. * @author Ethan Cohen
  17. */
  18. // ----------------------------------------------------------------------------
  19. // Rule Definition
  20. // ----------------------------------------------------------------------------
  21. var errorMessage = function errorMessage(role, requiredProps) {
  22. return "Elements with the ARIA role \"".concat(role, "\" must have the following attributes defined: ").concat(String(requiredProps).toLowerCase());
  23. };
  24. var schema = (0, _schemas.generateObjSchema)();
  25. var _default = {
  26. meta: {
  27. docs: {
  28. url: 'https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/tree/HEAD/docs/rules/role-has-required-aria-props.md',
  29. description: 'Enforce that elements with ARIA roles must have all required attributes for that role.'
  30. },
  31. schema: [schema]
  32. },
  33. create: function create(context) {
  34. var elementType = (0, _getElementType["default"])(context);
  35. return {
  36. JSXAttribute: function JSXAttribute(attribute) {
  37. var name = (0, _jsxAstUtils.propName)(attribute).toLowerCase();
  38. if (name !== 'role') {
  39. return;
  40. }
  41. var type = elementType(attribute.parent);
  42. if (!_ariaQuery.dom.get(type)) {
  43. return;
  44. }
  45. var roleAttrValue = (0, _jsxAstUtils.getLiteralPropValue)(attribute);
  46. var attributes = attribute.parent.attributes; // If value is undefined, then the role attribute will be dropped in the DOM.
  47. // If value is null, then getLiteralAttributeValue is telling us
  48. // that the value isn't in the form of a literal.
  49. if (roleAttrValue === undefined || roleAttrValue === null) {
  50. return;
  51. }
  52. var normalizedValues = String(roleAttrValue).toLowerCase().split(' ');
  53. var validRoles = normalizedValues.filter(function (val) {
  54. return (0, _toConsumableArray2["default"])(_ariaQuery.roles.keys()).indexOf(val) > -1;
  55. }); // Check semantic DOM elements
  56. // For example, <input type="checkbox" role="switch" />
  57. if ((0, _isSemanticRoleElement["default"])(type, attributes)) {
  58. return;
  59. } // Check arbitrary DOM elements
  60. validRoles.forEach(function (role) {
  61. var _roles$get = _ariaQuery.roles.get(role),
  62. requiredPropKeyValues = _roles$get.requiredProps;
  63. var requiredProps = Object.keys(requiredPropKeyValues);
  64. if (requiredProps.length > 0) {
  65. var hasRequiredProps = requiredProps.every(function (prop) {
  66. return (0, _jsxAstUtils.getProp)(attributes, prop);
  67. });
  68. if (hasRequiredProps === false) {
  69. context.report({
  70. node: attribute,
  71. message: errorMessage(role.toLowerCase(), requiredProps)
  72. });
  73. }
  74. }
  75. });
  76. }
  77. };
  78. }
  79. };
  80. exports["default"] = _default;
  81. module.exports = exports.default;