Soft disabling using `aria-disabled` rather than `disabled` attribute

aria_disabled.js

/**
 * Helper functions for managing button disabling through `aria-disabled`
 * rather than the `disabled` attribute, which is less accessible.
 * Includes functions for setting the disabled state, 
 * testing whether an element is disabled and a listener for preventing events
 * @module aria_disabled
 */

/**
 * @param {HTMLElement} element
 */
export function enable(element) {
  element.removeAttribute('aria-disabled');
}


/**
 * @param {HTMLElement} element
 */
export function disable(element) {
  element.setAttribute('aria-disabled', 'true');
}


/**
 * @param {HTMLElement} element
 */
export function isDisabled(element) {
  return element.getAttribute('aria-disabled') == 'true';
}


/**
 * @param {HTMLElement} element
 */
export function withinDisabled(element) {
  return element.closest('[aria-disabled="true"]');
}

/**
 * @param {Event} event
 * @example
 * ```
 * document.addEventListener('click', preventEventIfDisabled, true);
 * ```
 */
export function preventEventIfDisabled(event) {
  // The event's target may be a `<span>` or `<svg>` inside the `<button>`
  if (withinDisabled(event.target)) {
    // Prevent the browser from doing whatever it would have done
    event.preventDefault();
    // Prevent other JS code from getting an event,
    // making it like the event never happened
    event.stopImmediatePropagation();
  }
}