axe-core/lib/commons/forms/is-disabled.js

Accessibility engine for automated Web UI testing

const disabledNodeNames = ['fieldset', 'button', 'select', 'input', 'textarea'];

/**
 * Determines if an element disabled, or part of a disabled element
 *
 * IMPORANT: This method is fairly loose. There are significant differences in browsers of when
 * they'll announce a thing disabled. This tells us if any accessibility supported browser
 * identifies an element as disabled, but not if all of them do.
 *
 * @method isDisabled
 * @memberof axe.commons.forms
 * @param {VirtualNode} virtualNode
 * @return {boolean} whether or not the element is disabled in some way
 */
function isDisabled(virtualNode) {
  let disabledState = virtualNode._isDisabled;
  if (typeof disabledState === 'boolean') {
    return disabledState; // From cache
  }

  const { nodeName } = virtualNode.props;
  const ariaDisabled = virtualNode.attr('aria-disabled');
  if (disabledNodeNames.includes(nodeName) && virtualNode.hasAttr('disabled')) {
    disabledState = true; // Native
  } else if (ariaDisabled) {
    // ARIA
    disabledState = ariaDisabled.toLowerCase() === 'true';
  } else if (virtualNode.parent) {
    // Inherited
    disabledState = isDisabled(virtualNode.parent);
  } else {
    // Default
    disabledState = false;
  }

  virtualNode._isDisabled = disabledState;
  return disabledState;
}

export default isDisabled;