Major Changes

• b6ea4b5: Breaking: Fixed a long-standing bug where onPostActivate() would be called before the initial focus node was focused and the trap was fully activated. (#1747)
  • By default (and for many years now), a trap delays setting focus to the initial focus node to the next frame (setTimeout(0)) but wasn't delaying calling onPostActivate() until after that delay.
  • With the new isolateSubtrees='aria-hidden' option, the currently-focused node's container (a non-subtree being "disabled") would get hidden before the delay was up, resulting in Chrome preventing the effect of aria-hidden on that subtree with a warning in the console due to the container being hidden still containing focus (e.g. the "activate trap" button).
  • With the fix, subtree isolation and the call to onPostActivate() await the initial focus delay (if there is one, which is default behavior; remove it with delayInitialFocus=false) before being applied/called.
  • This may cause tests to fail, requiring the addition of slight delays before testing a given state (e.g. await waitFor(() => expect(initialFocusNode).toBeFocused()).
  • It may also disrupt current assumptions about the state of the initial focus node in code that runs in your onPostActivate() handler (prior to this change, that node would not be focused yet; after this change, it will be focused).

Minor Changes

• c214581: Adds aria-hidden support to isolateSubtrees config option

Patch Changes

• bb36e15: Fix undefined method _setSubtreeIsolation crash when using trapStack in DOM with older versions of Focus-trap (#1729)

Patch Changes

• a386578: Bump tabbable dependency for improved inert handling

Minor Changes

• 14b9155: Adds a new feature "isolateSubtrees", allowing focus-trap to prevent screen readers from reading content outside the trap. (#1575)

Patch Changes

• dcd4ae9: Update tabbable dependency to 6.3.0 for new displayCheck option.

Patch Changes

• d51ad78: Allow activation element in shadow DOM to be auto-focused after trap is deactivated

Patch Changes

• bb47f7a: Remove engine requirement that crept into package.json. Sorry about that! (#1343)

Patch Changes

• 0a9b746: Prevent a previous focus trap that is manually paused from being automatically unpaused when the current trap is deactivated. Also prevent a paused trap that is not at the top of the stack from being unpaused.

Patch Changes

• d4a4c34: Replace findIndex with native implementation - [Closes #1305](#1305

Patch Changes

• fc5910d: Fix fallbackFocus not used when initialFocus is selector to non-existent node (#1218)