Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs] Add more detail to tooltip vs. popover guidelines #2196

Open
hellogreg opened this issue Mar 4, 2025 · 0 comments · May be fixed by #2209
Open

[docs] Add more detail to tooltip vs. popover guidelines #2196

hellogreg opened this issue Mar 4, 2025 · 0 comments · May be fixed by #2209
Assignees
Labels
docs Improvements or additions to documentation

Comments

@hellogreg
Copy link
Collaborator

hellogreg commented Mar 4, 2025

Based on some side chats with @heyMP, we think it could be helpful to expand a bit on the differences between (and use cases for) tooltip and popover, as currently written on the tooltip guidelines page.

Perhaps a table with the following info would be helpful--or just keep them in lists like this!

Tooltip

  1. Appears when triggering element receives mouse hover, keyboard focus, or is tapped.
  2. Contains only plain text.
  3. Has no internal means of dismissal (e.g., a close button).
  4. Dismissed when triggering element loses hover/focus, or when a touchscreen user taps elsewhere.

Popover

  1. Appears when triggering button is clicked.
  2. Can contain headings, images, and interactive content (e.g., links).
  3. Has a close button.
  4. Dismissed when close button is clicked, user presses esc, or user clicks/taps outside the popover.

We may also want to ask implementors to investigate whether a toolitp/popover is appropriate at all. If info is helpful enough that it warrants including in a tooltip, why is it being hidden by default? Not saying tooltips are bad! Just saying we should always be mindful about why we're using them.

@hellogreg hellogreg added the docs Improvements or additions to documentation label Mar 4, 2025
@hellogreg hellogreg added this to the 2025/Q1 — Cubone release milestone Mar 4, 2025
@hellogreg hellogreg self-assigned this Mar 4, 2025
@hellogreg hellogreg moved this from Backlog to Todo in Red Hat Design System Mar 4, 2025
@hellogreg hellogreg linked a pull request Mar 10, 2025 that will close this issue
@hellogreg hellogreg moved this from Todo to Review 🔍 in Red Hat Design System Mar 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to documentation
Projects
Status: Review 🔍
Development

Successfully merging a pull request may close this issue.

1 participant