From e4ec281d894ed6d9557c503acda86e5d2c063289 Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Wed, 17 Jun 2026 11:15:52 +0000 Subject: [PATCH 1/6] feat(desktop): add tooltips to disabled icon buttons Adds standard browser tooltips (`title` attribute) to the disabled "Settings" and "Help" icon-only buttons in the sidebar. This clarifies to sighted users why the buttons are disabled ("coming soon") since they otherwise lack visual context despite having `aria-label`s for screen readers. --- .Jules/palette.md | 3 +++ apps/desktop/src/App.tsx | 4 ++-- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/.Jules/palette.md b/.Jules/palette.md index c172c381..935ba797 100644 --- a/.Jules/palette.md +++ b/.Jules/palette.md @@ -5,3 +5,6 @@ ## 2026-06-13 - Added screen reader text for tooltip divs **Learning:** When using `title` attributes on non-interactive elements like icon-only `div`s for tooltips, screen readers might not announce them properly because they aren't focusable. The visual tooltip is not enough for accessibility. **Action:** Always add a visually hidden `[Tooltip Text]` inside non-interactive elements that rely on a `title` attribute so that screen readers have text content to announce. +## 2024-05-24 - Visual tooltips for disabled icon-only buttons +**Learning:** Icon-only buttons with `aria-label` are accessible to screen readers, but sighted users relying on mouse hover don't get context if the `title` attribute is missing, especially when the button is disabled and its purpose is unclear (e.g. "coming soon"). +**Action:** Always add a `title` attribute mirroring the `aria-label` (or providing a specific disabled reason) to icon-only buttons so sighted users also receive explanatory tooltips on hover. diff --git a/apps/desktop/src/App.tsx b/apps/desktop/src/App.tsx index 9486ae12..0ee97858 100644 --- a/apps/desktop/src/App.tsx +++ b/apps/desktop/src/App.tsx @@ -438,10 +438,10 @@ export function App() {
- -
From e2842ec959ada0345c947737281fe6e0c607ba32 Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Wed, 17 Jun 2026 12:02:46 +0000 Subject: [PATCH 2/6] feat(desktop): add tooltips to disabled icon buttons Adds standard browser tooltips (`title` attribute) to the disabled "Settings" and "Help" icon-only buttons in the sidebar. This clarifies to sighted users why the buttons are disabled ("coming soon") since they otherwise lack visual context despite having `aria-label`s for screen readers. From a60743478dc410fc58fd19a50206dfbaee4dce21 Mon Sep 17 00:00:00 2001 From: Seongho Bae Date: Wed, 17 Jun 2026 21:36:57 +0900 Subject: [PATCH 3/6] docs: order palette learning entries --- .Jules/palette.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/.Jules/palette.md b/.Jules/palette.md index 935ba797..bb0f82a6 100644 --- a/.Jules/palette.md +++ b/.Jules/palette.md @@ -2,9 +2,10 @@ **Learning:** Interactive inline buttons (like the chord editor) and scrollable regions with `tabIndex={0}` do not automatically get focus visible styles, meaning keyboard users tabbing through won't know they are focused on them. Unlike central `