React Aria tooltip does not open when the trigger element receives focus after scrolling.

[Vinit-Pandit]

Provide a general summary of the issue here

Tooltip does not open when the trigger element is focused after scrolling.

🤔 Expected Behavior?

Tooltip should open when the trigger element is focused after scrolling.

😯 Current Behavior

Tooltip does not open when the trigger element is focused after scrolling.

💁 Possible Solution

adding delay on focus of the trigger element ? .

🔦 Context

When the trigger element is out of view, pressing Tab moves focus to it and the page scrolls automatically, but the tooltip does not open in this scenario.

🖥️ Steps to Reproduce

Use tab and focus to the button which is on the end of the page .

https://codesandbox.io/p/sandbox/nervous-diffie-forked-gkqc7l

Version

1.15.1

What browsers are you seeing the problem on?

Chrome

If other, please specify.

No response

What operating system are you using?

Window 11

🧢 Your Company/Team

No response

🕷 Tracking Issue

No response

[snowystinger]

I think you left a controlled open on the tooltip, can you fix up your sandbox so it demonstrates the issue? You could handle this by controlling the open state of the tooltip, then you could delay opening it until the scrolling has stopped.

I suspect it's closing because of this though

react-spectrum/packages/@react-aria/overlays/src/useCloseOnScroll.ts

Line 31 in a9fccbd

export function useCloseOnScroll(opts: CloseOnScrollOptions): void {

and we'd be reluctant to change the behaviour because if the tooltip is open AND THEN scrolled, we'd want it to close. I'm not sure if the events are in the opposite order though in this case. If they are, then maybe we could differentiate and special case scrolling the trigger element into view.

[Vinit-Pandit]

focusObscuredRecording.mp4

I’m experiencing same on website as well. Would it be possible to add a delay parameter to the onFocus event
same as we have for hover .

@snowystinger ?

[snowystinger]

Would it be possible to add a delay parameter to the onFocus event same as we have for hover

I don't think this this something we'd like to do, the delay on hover is because people move their mouse over things all the time without intending to interact with it. With keyboard, things are a little more deliberate, so the immediate feedback is needed.

Have you tried my previous suggestion?

You could handle this by controlling the open state of the tooltip, then you could delay opening it until the scrolling has stopped.

We might be able to build this into our tooltip trigger as well using onScrollEnd checks on all of the parents.

[Vinit-Pandit]

Manual Open State Management Discussion

When we manage the open state manually, we also become responsible for explicitly handling the close state.

I tried implementing your suggestion of setting open to true after a delay once the scroll event occurs. However, this introduced a few additional challenges:

1. Close Handling Becomes Manual

We now need to explicitly handle closing the tooltip.

For example, we must add logic to close it when the Esc key is pressed.

2. Hover Behavior Breaks

With the suggested changes, the tooltip no longer persists properly when hovering over it.

Since we already close the tooltip when the mouse pointer moves away from the trigger text, manually controlling open conflicts with that behavior.

3. Increased Complexity

What was previously handled automatically by the library (open/close lifecycle, keyboard handling, hover behavior) now needs to be managed manually.

This increases both implementation complexity and maintenance overhead.

Because of these side effects, the current approach appears to introduce more issues than it resolves.