[GH-ISSUE #3310] [FR] Delay tooltip presentations #1459

Closed
opened 2026-03-23 20:49:30 +00:00 by mirror · 5 comments
Owner

Originally created by @intonarumori on GitHub (Sep 1, 2023).
Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/3310

Originally assigned to: @AdiAr11 on GitHub.

Description

  • Set tooltip presentation delay to ~300ms.
  • And/or Remove tooltip interactivity

Currently tooltips appear almost immediately when hovering over items:

  • they can obstruct other interactive elements as first you have to click to hide the tooltip before being able to click on them
    Example:
    Screenshot 2023-09-01 at 14 01 52
Screenshot 2023-09-01 at 14 08 45
  • They create visual clutter as moving the mouse around
  • Windows and macOS both delay tooltips, so a delay also aligns with platform conventions better

Impact

  • Improves the overall feel of the app by appearing more clean
  • Creates less visual clutter for users who already know their way around the app and click intentionally and fast

Additional Context

No response

Originally created by @intonarumori on GitHub (Sep 1, 2023). Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/3310 Originally assigned to: @AdiAr11 on GitHub. ### Description - Set tooltip presentation delay to ~300ms. - And/or Remove tooltip interactivity Currently tooltips appear almost immediately when hovering over items: - they can obstruct other interactive elements as first you have to click to hide the tooltip before being able to click on them Example: <img width="138" alt="Screenshot 2023-09-01 at 14 01 52" src="https://github.com/AppFlowy-IO/AppFlowy/assets/86030/5cf74c99-14f7-4433-9d22-cce45cc805d7"> <img width="226" alt="Screenshot 2023-09-01 at 14 08 45" src="https://github.com/AppFlowy-IO/AppFlowy/assets/86030/8c64552f-4624-4693-815d-aad957f44dc4"> - They create visual clutter as moving the mouse around - Windows and macOS both delay tooltips, so a delay also aligns with platform conventions better ### Impact - Improves the overall feel of the app by appearing more clean - Creates less visual clutter for users who already know their way around the app and click intentionally and fast ### Additional Context _No response_
Author
Owner

@AdiAr11 commented on GitHub (Sep 2, 2023):

Hi @MayurSMahajan , I would like to work on this issue. Should we add a delay of around 300 ms before showing the tooltip? Or anything else also needs to be done?

<!-- gh-comment-id:1703762078 --> @AdiAr11 commented on GitHub (Sep 2, 2023): Hi @MayurSMahajan , I would like to work on this issue. Should we add a delay of around 300 ms before showing the tooltip? Or anything else also needs to be done?
Author
Owner

@MayurSMahajan commented on GitHub (Sep 2, 2023):

@AdiAr11 Thanks for helping, Assigned!
cc @Xazin @LucasXu0 is 300ms delay desirable to us, or we should use some other value?

<!-- gh-comment-id:1703788474 --> @MayurSMahajan commented on GitHub (Sep 2, 2023): @AdiAr11 Thanks for helping, Assigned! cc @Xazin @LucasXu0 is 300ms delay desirable to us, or we should use some other value?
Author
Owner

@intonarumori commented on GitHub (Sep 3, 2023):

I looked more into it.

I think the takeaways are:

  • Any delay of > 100-200ms improves the feel of the app by not presenting tooltips all over the place just by hovering
  • 1 sec is the default for macOS apps (which some people find too slow), but it's up the the application developer to override it (more info here)
    Use the following command to see some overrides: defaults read | grep "NSInitialToolTipDelay"

Some examples:

"org.audacityteam.audacity" =     {
        NSInitialToolTipDelay = 1000;
}
"us.zoom.xos" =     {
        NSInitialToolTipDelay = 100;
}
  • Looks like we have to come up with something reasonable, to me it seems something in the range of 200-500ms would be nice.
<!-- gh-comment-id:1704143987 --> @intonarumori commented on GitHub (Sep 3, 2023): I looked more into it. I think the takeaways are: - Any delay of > 100-200ms improves the feel of the app by not presenting tooltips all over the place just by hovering - 1 sec is the default for macOS apps (which some people find too slow), but it's up the the application developer to override it (more info [here](https://apple.stackexchange.com/questions/328908/how-to-reduce-tooltip-appearance-delay-in-xcode)) Use the following command to see some overrides: `defaults read | grep "NSInitialToolTipDelay"` Some examples: ``` "org.audacityteam.audacity" = { NSInitialToolTipDelay = 1000; } "us.zoom.xos" = { NSInitialToolTipDelay = 100; } ``` - Looks like we have to come up with something reasonable, to me it seems something in the range of 200-500ms would be nice.
Author
Owner

@MayurSMahajan commented on GitHub (Sep 3, 2023):

Yes, I think something in the range of 100ms to 300ms.

<!-- gh-comment-id:1704313550 --> @MayurSMahajan commented on GitHub (Sep 3, 2023): Yes, I think something in the range of 100ms to 300ms.
Author
Owner

@Xazin commented on GitHub (Sep 4, 2023):

https://api.flutter.dev/flutter/material/Tooltip/waitDuration.html

300ms in my opinion would be nice.

<!-- gh-comment-id:1704968096 --> @Xazin commented on GitHub (Sep 4, 2023): https://api.flutter.dev/flutter/material/Tooltip/waitDuration.html 300ms in my opinion would be nice.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
AppFlowy-IO/AppFlowy#1459
No description provided.