@ou-imdt/utils/lib/closestFocusableDescendant.js

Utility library for interactive media development

import composedDescendants from './composedDescendants.js';
import firstFocusableNodeFrom from './firstFocusableNodeFrom.js';

/**
 * Finds the closest focusable descendant of a node.
 * @param {Node} node - The root node to start searching from.
 * @param {string} focusDelegate - The property name used as a focus delegate.
 * @returns {Node|null} The closest focusable descendant or `null` if none found.
 */
export default function closestFocusableDescendant(node, focusDelegate) {
  return firstFocusableNodeFrom(composedDescendants(node), focusDelegate);
}