Skip to content

🎨 Palette: Add missing tooltips to icon-only buttons#49

Open
NSEvent wants to merge 1 commit into
mainfrom
palette-missing-tooltips-7678132752822010327
Open

🎨 Palette: Add missing tooltips to icon-only buttons#49
NSEvent wants to merge 1 commit into
mainfrom
palette-missing-tooltips-7678132752822010327

Conversation

@NSEvent

@NSEvent NSEvent commented Jun 8, 2026

Copy link
Copy Markdown
Owner

💡 What: Added .help("Settings") and .help("Add profile") to their respective icon-only buttons.
🎯 Why: While screen readers could read .accessibilityLabel(), sighted mouse users on macOS had no tooltip hint for these critical icon buttons.
Accessibility: Enhanced visual hover discoverability for macOS users while maintaining existing VoiceOver support.


PR created automatically by Jules for task 7678132752822010327 started by @NSEvent

Summary by CodeRabbit

Accessibility

  • Added help tooltips to icon-only buttons on macOS, including Settings and Add Profile controls, to provide users with contextual guidance.

Added missing `.help()` modifiers to the "Add profile" and "Settings" icon-only buttons in `ProfileSidebarViews.swift` and `ContentToolbar.swift` to ensure symmetry with existing `.accessibilityLabel()` modifiers, improving micro-UX on macOS.

Co-authored-by: NSEvent <44446865+NSEvent@users.noreply.github.com>
@google-labs-jules

Copy link
Copy Markdown
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@coderabbitai

coderabbitai Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

This PR adds help tooltip accessibility to two icon-only buttons in macOS SwiftUI by applying .help() modifiers to the Settings button in ContentToolbar and the "Add profile" button in ProfileSidebarViews. A new palette guideline documents the pattern and requirement.

Changes

Icon-Only Button Help Tooltips

Layer / File(s) Summary
Accessibility guideline documentation
.Jules/palette.md
New palette entry documents the pattern of pairing .accessibilityLabel() with .help() on macOS SwiftUI icon-only buttons, citing the two instances fixed in this PR.
Help tooltip implementations
XboxControllerMapper/XboxControllerMapper/Views/MainWindow/ContentToolbar.swift, XboxControllerMapper/XboxControllerMapper/Views/MainWindow/ProfileSidebarViews.swift
Settings button and "Add profile" button each receive a .help() modifier providing hover tooltip text for accessibility.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🐰 Buttons whisper their secrets now,
Help and labels, hand in hand,
Settings gear, profiles added too—
Accessibility sweeps the land! 🎁

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title mentions the emoji prefix (🎨 Palette:) which adds noise, but accurately describes the main change: adding tooltips to icon-only buttons across the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch palette-missing-tooltips-7678132752822010327

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.Jules/palette.md:
- Line 11: Replace the literal shell placeholder string "$(date +%Y-%m-%d)" in
the heading "## $(date +%Y-%m-%d) - Found instances lacking symmetric
accessibility labels" with a concrete ISO date (YYYY-MM-DD) so the entry shows
an actual date (e.g., "## 2026-06-08 - Found instances lacking symmetric
accessibility labels"); update that heading to use the desired commit date
before finalizing the change.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 704fff87-8b72-44dd-9d07-8f70b7c0337e

📥 Commits

Reviewing files that changed from the base of the PR and between a37c34d and e4c79c2.

📒 Files selected for processing (3)
  • .Jules/palette.md
  • XboxControllerMapper/XboxControllerMapper/Views/MainWindow/ContentToolbar.swift
  • XboxControllerMapper/XboxControllerMapper/Views/MainWindow/ProfileSidebarViews.swift

Comment thread .Jules/palette.md
## 2026-06-06 - Ensure Symmetry in Accessibility and Tooltips for SwiftUI Icon Buttons
**Learning:** In macOS SwiftUI applications, icon-only buttons often have either `.help()` (for hover tooltips) or `.accessibilityLabel()` (for VoiceOver), but frequently lack both. Both are necessary because they serve different user interaction models—`.help` for visual hover feedback and `.accessibilityLabel` for screen readers.
**Action:** When adding or reviewing icon-only buttons in SwiftUI, always ensure symmetry by defining both `.help("Description")` and `.accessibilityLabel("Description")` to cover all accessibility and usability vectors.
## $(date +%Y-%m-%d) - Found instances lacking symmetric accessibility labels

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Replace the literal shell placeholder with a concrete date.

$(date +%Y-%m-%d) is committed as plain text, so this entry won’t show an actual date like the rest of the palette history. Use a real ISO date string in the heading.

Suggested fix
-## $(date +%Y-%m-%d) - Found instances lacking symmetric accessibility labels
+## 2026-06-08 - Found instances lacking symmetric accessibility labels
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
## $(date +%Y-%m-%d) - Found instances lacking symmetric accessibility labels
## 2026-06-08 - Found instances lacking symmetric accessibility labels
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.Jules/palette.md at line 11, Replace the literal shell placeholder string
"$(date +%Y-%m-%d)" in the heading "## $(date +%Y-%m-%d) - Found instances
lacking symmetric accessibility labels" with a concrete ISO date (YYYY-MM-DD) so
the entry shows an actual date (e.g., "## 2026-06-08 - Found instances lacking
symmetric accessibility labels"); update that heading to use the desired commit
date before finalizing the change.

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.

1 participant