accessibility.js 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169
  1. /**
  2. * DevExtreme (ui/shared/accessibility.js)
  3. * Version: 19.1.16
  4. * Build date: Tue Oct 18 2022
  5. *
  6. * Copyright (c) 2012 - 2022 Developer Express Inc. ALL RIGHTS RESERVED
  7. * Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
  8. */
  9. "use strict";
  10. var _renderer = require("../../core/renderer");
  11. var _renderer2 = _interopRequireDefault(_renderer);
  12. var _events_engine = require("../../events/core/events_engine");
  13. var _events_engine2 = _interopRequireDefault(_events_engine);
  14. var _utils = require("../../events/utils");
  15. var _utils2 = _interopRequireDefault(_utils);
  16. var _extend = require("../../core/utils/extend");
  17. function _interopRequireDefault(obj) {
  18. return obj && obj.__esModule ? obj : {
  19. "default": obj
  20. }
  21. }
  22. var FOCUS_STATE_CLASS = "dx-state-focused";
  23. var FOCUS_DISABLED_CLASS = "dx-cell-focus-disabled";
  24. var FOCUSED_ROW_SELECTOR = ".dx-row-focused";
  25. var GRID_ROW_SELECTOR = ".dx-datagrid-rowsview .dx-row";
  26. var GRID_CELL_SELECTOR = "".concat(GRID_ROW_SELECTOR, " > td");
  27. var TREELIST_ROW_SELECTOR = ".dx-treelist-rowsview .dx-row";
  28. var TREELIST_CELL_SELECTOR = "".concat(TREELIST_ROW_SELECTOR, " > td");
  29. var viewItemSelectorMap = {
  30. groupPanel: [".dx-datagrid-group-panel .dx-group-panel-item[tabindex]"],
  31. columnHeaders: [".dx-datagrid-headers .dx-header-row > td.dx-datagrid-action", ".dx-treelist-headers .dx-header-row > td.dx-treelist-action"],
  32. filterRow: [".dx-datagrid-headers .dx-datagrid-filter-row .dx-editor-cell .dx-texteditor-input", ".dx-treelist-headers .dx-treelist-filter-row .dx-editor-cell .dx-texteditor-input"],
  33. rowsView: ["".concat(FOCUSED_ROW_SELECTOR), "".concat(GRID_ROW_SELECTOR, "[tabindex]"), "".concat(GRID_CELL_SELECTOR, "[tabindex]"), "".concat(GRID_CELL_SELECTOR), "".concat(TREELIST_ROW_SELECTOR, "[tabindex]"), "".concat(TREELIST_CELL_SELECTOR, "[tabindex]"), "".concat(TREELIST_CELL_SELECTOR)],
  34. footer: [".dx-datagrid-total-footer .dx-datagrid-summary-item", ".dx-treelist-total-footer .dx-treelist-summary-item"],
  35. filterPanel: [".dx-datagrid-filter-panel .dx-icon-filter", ".dx-treelist-filter-panel .dx-icon-filter"],
  36. pager: [".dx-datagrid-pager [tabindex]", ".dx-treelist-pager [tabindex]"]
  37. };
  38. var isMouseDown = false;
  39. var isHiddenFocusing = false;
  40. var focusedElementInfo = null;
  41. function processKeyDown(viewName, instance, event, action, $mainElement, executeKeyDown) {
  42. var isHandled = fireKeyDownEvent(instance, event.originalEvent, executeKeyDown);
  43. if (isHandled) {
  44. return
  45. }
  46. var keyName = _utils2.default.normalizeKeyName(event);
  47. if ("enter" === keyName || "space" === keyName) {
  48. saveFocusedElementInfo(event.target, instance);
  49. action && action({
  50. event: event
  51. })
  52. } else {
  53. if ("tab" === keyName) {
  54. $mainElement.addClass(FOCUS_STATE_CLASS)
  55. } else {
  56. module.exports.selectView(viewName, instance, event)
  57. }
  58. }
  59. }
  60. function saveFocusedElementInfo(target, instance) {
  61. var $target = (0, _renderer2.default)(target);
  62. var ariaLabel = $target.attr("aria-label");
  63. var $activeElements = getActiveAccessibleElements(ariaLabel, instance.element());
  64. var targetIndex = $activeElements.index($target);
  65. focusedElementInfo = (0, _extend.extend)({}, {
  66. ariaLabel: ariaLabel,
  67. index: targetIndex
  68. }, {
  69. viewInstance: instance
  70. })
  71. }
  72. function getActiveAccessibleElements(ariaLabel, viewElement) {
  73. var $viewElement = (0, _renderer2.default)(viewElement);
  74. var $activeElements;
  75. if (ariaLabel) {
  76. $activeElements = $viewElement.find('[aria-label="'.concat(ariaLabel, '"][tabindex]'))
  77. } else {
  78. $activeElements = $viewElement.find("[tabindex]")
  79. }
  80. return $activeElements
  81. }
  82. function findFocusedViewElement(viewSelectors) {
  83. for (var index in viewSelectors) {
  84. var selector = viewSelectors[index];
  85. var $focusViewElement = (0, _renderer2.default)(selector).first();
  86. if ($focusViewElement.length) {
  87. return $focusViewElement
  88. }
  89. }
  90. }
  91. function fireKeyDownEvent(instance, event, executeAction) {
  92. var args = {
  93. event: event,
  94. handled: false
  95. };
  96. if (executeAction) {
  97. executeAction(args)
  98. } else {
  99. instance._createActionByOption("onKeyDown")(args)
  100. }
  101. return args.handled
  102. }
  103. module.exports = {
  104. hiddenFocus: function(element) {
  105. isHiddenFocusing = true;
  106. element.focus();
  107. isHiddenFocusing = false
  108. },
  109. registerKeyboardAction: function(viewName, instance, $element, selector, action, executeKeyDown) {
  110. if (instance.option("useLegacyKeyboardNavigation")) {
  111. return
  112. }
  113. var $mainElement = (0, _renderer2.default)(instance.element());
  114. _events_engine2.default.on($element, "keydown", selector, function(e) {
  115. return processKeyDown(viewName, instance, e, action, $mainElement, executeKeyDown)
  116. });
  117. _events_engine2.default.on($element, "mousedown", selector, function() {
  118. isMouseDown = true;
  119. $mainElement.removeClass(FOCUS_STATE_CLASS)
  120. });
  121. _events_engine2.default.on($element, "focusin", selector, function() {
  122. if (!isMouseDown && !isHiddenFocusing) {
  123. $mainElement.addClass(FOCUS_STATE_CLASS)
  124. }
  125. isMouseDown = false
  126. })
  127. },
  128. restoreFocus: function(instance) {
  129. if (!instance.option("useLegacyKeyboardNavigation") && focusedElementInfo) {
  130. var viewInstance = focusedElementInfo.viewInstance;
  131. if (viewInstance) {
  132. var $activeElements = getActiveAccessibleElements(focusedElementInfo.ariaLabel, viewInstance.element());
  133. var $targetElement = $activeElements.eq(focusedElementInfo.index);
  134. focusedElementInfo = null;
  135. _events_engine2.default.trigger($targetElement, "focus")
  136. }
  137. }
  138. },
  139. selectView: function(viewName, instance, event) {
  140. var keyName = _utils2.default.normalizeKeyName(event);
  141. if (event.ctrlKey && ("upArrow" === keyName || "downArrow" === keyName)) {
  142. var viewNames = Object.keys(viewItemSelectorMap);
  143. var viewItemIndex = viewNames.indexOf(viewName);
  144. while (viewItemIndex >= 0 && viewItemIndex < viewNames.length) {
  145. viewItemIndex = "upArrow" === keyName ? --viewItemIndex : ++viewItemIndex;
  146. var _viewName = viewNames[viewItemIndex];
  147. var viewSelectors = viewItemSelectorMap[_viewName];
  148. var $focusViewElement = findFocusedViewElement(viewSelectors);
  149. if ($focusViewElement && $focusViewElement.length) {
  150. $focusViewElement.attr("tabindex", instance.option("tabindex") || 0);
  151. _events_engine2.default.trigger($focusViewElement, "focus");
  152. $focusViewElement.removeClass(FOCUS_DISABLED_CLASS);
  153. break
  154. }
  155. }
  156. }
  157. },
  158. setTabIndex: function(instance, $element) {
  159. if (!instance.option("useLegacyKeyboardnavigation")) {
  160. $element.attr("tabindex", instance.option("tabindex") || 0)
  161. }
  162. }
  163. };