Skip to content

🎨 Palette: Improve accessibility for OAuth docs external link button - #198

Open
MillionthOdin16 wants to merge 1 commit into
mainfrom
palette/oauth-docs-aria-label-9913244441165795710
Open

MillionthOdin16 wants to merge 1 commit into
mainfrom
palette/oauth-docs-aria-label-9913244441165795710

Conversation

@MillionthOdin16

@MillionthOdin16 MillionthOdin16 commented Jul 30, 2026 •

Copy link
Copy Markdown
Owner

💡 What: Added aria-label and tabIndex={-1} to the ExternalLink icon button within the OAuthProvidersCard.
🎯 Why: The icon-only button lacked accessible context and could cause redundant tab stops when nested inside an anchor tag that handles the actual navigation.
📸 Before/After: No visual changes, strictly DOM accessibility improvements.
♿ Accessibility: Screen readers now correctly identify the external docs link via the aria-label, and keyboard navigation is streamlined by removing the inner button from the tab order.


PR created automatically by Jules for task 9913244441165795710 started by @MillionthOdin16

Summary by CodeRabbit

  • Accessibility Improvements
    • Improved the accessibility and keyboard navigation behavior of OAuth provider documentation links.
    • Added a descriptive label for the documentation link icon.

…nk button

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
@google-labs-jules

Copy link
Copy Markdown

👋 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.

Copilot AI review requested due to automatic review settings July 30, 2026 18:54

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@gemini-code-assist

Copy link
Copy Markdown

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@coderabbitai

coderabbitai Bot commented Jul 30, 2026 •

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The OAuth provider documentation icon button now has an explicit accessible label and is excluded from sequential keyboard focus within the documentation link.

Changes

OAuth documentation link accessibility

Layer / File(s) Summary
Docs button accessibility attributes
web/src/components/OAuthProvidersCard.tsx
The “Open {provider} docs” icon button now includes an aria-label and tabIndex={-1}.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

Suggested reviewers: copilot, austinpickett

🚥 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 clearly matches the main change: improving accessibility for the OAuth docs external link button.
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.
✨ 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/oauth-docs-aria-label-9913244441165795710

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 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 `@web/src/components/OAuthProvidersCard.tsx`:
- Around line 225-230: Update the documentation-link control around the Button
in OAuthProvidersCard so it renders only one interactive element. Use the anchor
as the styled icon control, or use Button’s supported anchor/polymorphic mode,
and remove the nested button while preserving the docs URL, icon styling,
accessible label, and link behavior.
- Line 228: Update OAuthProvidersCard’s provider documentation link to use a
translated “open provider docs” string from the existing useI18n() setup, and
reuse that localized value for both aria-label and title instead of constructing
a hardcoded English label.
🪄 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: 9de5013d-cd37-473d-8fc2-dd73d1a3060b

📥 Commits

Reviewing files that changed from the base of the PR and between 1ea2ea1 and 23aea64.

📒 Files selected for processing (1)
  • web/src/components/OAuthProvidersCard.tsx

Comment on lines +225 to +230
<Button
ghost
size="icon"
aria-label={`Open ${p.name} docs`}
tabIndex={-1}
>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Do not nest an interactive button inside the documentation link.

tabIndex={-1} removes the inner button from sequential focus but it remains a second interactive element inside <a>, leaving ambiguous semantics for assistive technologies. Render a single interactive control instead: make the anchor the styled icon control or use the Button component’s supported anchor/polymorphic mode.

🤖 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 `@web/src/components/OAuthProvidersCard.tsx` around lines 225 - 230, Update the
documentation-link control around the Button in OAuthProvidersCard so it renders
only one interactive element. Use the anchor as the styled icon control, or use
Button’s supported anchor/polymorphic mode, and remove the nested button while
preserving the docs URL, icon styling, accessible label, and link behavior.

<Button
ghost
size="icon"
aria-label={`Open ${p.name} docs`}

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Localize the accessible label.

The new aria-label is hardcoded in English despite this component using useI18n(). Add a translated “open provider docs” string and reuse it for both aria-label and title.

🤖 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 `@web/src/components/OAuthProvidersCard.tsx` at line 228, Update
OAuthProvidersCard’s provider documentation link to use a translated “open
provider docs” string from the existing useI18n() setup, and reuse that
localized value for both aria-label and title instead of constructing a
hardcoded English label.

This branch has not been deployed

No deployments
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.

2 participants