Skip to content

fix: use RichTooltip for help icons in Safari/Edge#557

Open
Br1an67 wants to merge 1 commit intoOpenBMB:mainfrom
Br1an67:fix/issue-538-safari-tooltip
Open

fix: use RichTooltip for help icons in Safari/Edge#557
Br1an67 wants to merge 1 commit intoOpenBMB:mainfrom
Br1an67:fix/issue-538-safari-tooltip

Conversation

@Br1an67
Copy link

@Br1an67 Br1an67 commented Mar 1, 2026

Problem

Help icon tooltips (the ? icons next to form field labels) do not appear in Safari and Edge on macOS, as reported in #538.

Root Cause

The help icons in DynamicFormField.vue used native HTML title attributes for tooltips. The native title attribute has inconsistent behavior across browsers — particularly in Safari and Edge, where:

  • Tooltips require a long hover delay (~2s) before appearing
  • They don't respond to click/tap interactions
  • They have no keyboard accessibility

Solution

Replaced all 11 native title-based help icons with the existing RichTooltip component, which already provides:

  • Consistent cross-browser tooltip rendering
  • Hover activation with configurable delay
  • Keyboard accessibility (Space/Enter to toggle, Escape to dismiss)
  • Rich content support (title, description, examples, learn more links)
  • Proper positioning with viewport boundary detection

Changes

  • frontend/src/components/DynamicFormField.vue: Wrapped all help icon <span> elements with <RichTooltip> and added tabindex="0" for keyboard focus. Imported the RichTooltip component.

Testing

  • vite build passes successfully
  • Pre-existing eslint warnings (unrelated vue/no-mutating-props) remain unchanged
  • No new warnings or errors introduced

Fixes #538

Replace native HTML title attributes on help icons with the
existing RichTooltip component for consistent cross-browser
tooltip behavior. The native title attribute has inconsistent
behavior across Safari and Edge, causing help tooltips to not
appear when users interact with the question mark icons.

Fixes OpenBMB#538
@NA-Wen
Copy link
Collaborator

NA-Wen commented Mar 3, 2026

Thanks a lot for the PR 👍

However, after further investigation on our side, it seems the tooltip issue in Safari/Edge may stem from a more fundamental cause: some help text are actually empty. In such cases, even replacing the native title attribute with RichTooltip would not render any content. So we plan to first address this at the data/schema level and then reassess whether a component-level change is still necessary.

So for now, we won’t be merging this PR. If we later confirm that a UI-level adjustment is still needed, we’ll follow up and move things forward accordingly. Thanks again for your contribution — we really appreciate it 🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Safari UI: help icon doesn't work

2 participants