Skip to content

Fix inaccurate accessible name on settings navigation landmark - #1822

Merged
SteveJonesDev merged 3 commits into
developfrom
steve/pro-975-navigation-landmark-uses-an-inaccurate-accessible-name
Jul 5, 2026
Merged

Fix inaccurate accessible name on settings navigation landmark#1822
SteveJonesDev merged 3 commits into
developfrom
steve/pro-975-navigation-landmark-uses-an-inaccurate-accessible-name

Conversation

@SteveJonesDev

@SteveJonesDev SteveJonesDev commented Jul 5, 2026

Copy link
Copy Markdown
Member

Short description: The settings page nav landmark was labeled aria-label="Settings Tabs" even though it contains plain navigation links, not an ARIA tabs widget (no role="tablist"/role="tab"). This mislabeling can mislead assistive technology users about the nature of the control. Changed the label to "Settings".

Fixes #1756

Checklist

  • PR is linked to the main issue in the repo
  • Tests are added that cover changes (not applicable — single string label change, no new logic)

Summary by CodeRabbit

  • Bug Fixes
    • Improved the settings page navigation label so screen readers announce clearer, more accurate text.

The settings page nav landmark was labeled "Settings Tabs" even though
it contains navigation links rather than an ARIA tabs widget. This
misleads assistive technology users about the nature of the control.

Fixes #1756
@coderabbitai

coderabbitai Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 112a1fcc-50bd-459e-a2ef-2e830d2136a5

📥 Commits

Reviewing files that changed from the base of the PR and between 36f7c0d and 7e09d1f.

📒 Files selected for processing (1)
  • partials/settings-page.php
✅ Files skipped from review due to trivial changes (1)
  • partials/settings-page.php

📝 Walkthrough

Walkthrough

The settings page navigation landmark in partials/settings-page.php now uses the accessible name “Accessibility Checker Settings” instead of “Settings Tabs”.

Changes

Accessible name correction

Layer / File(s) Summary
Fix nav aria-label text
partials/settings-page.php
Updated the aria-label on the <nav class="nav-tab-wrapper"> element from "Settings Tabs" to "Accessibility Checker Settings".

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

Related issues: #1756 – Navigation landmark used an inaccurate accessible name for a non-tab navigation interface.

Suggested labels: accessibility, bug, good first issue

Suggested reviewers: none

🚥 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 summarizes the accessibility-label fix on the settings navigation landmark.
Linked Issues check ✅ Passed The aria-label change makes the navigation landmark's accessible name better match its purpose as settings navigation.
Out of Scope Changes check ✅ Passed The change is limited to the settings navigation aria-label update and stays within the linked issue's scope.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ 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 steve/pro-975-navigation-landmark-uses-an-inaccurate-accessible-name

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

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the aria-label attribute of the settings navigation bar from 'Settings Tabs' to 'Settings' in partials/settings-page.php. The reviewer suggests wrapping this user-facing string in a WordPress translation function (esc_attr__()) to support internationalization.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread partials/settings-page.php Outdated
<?php
if ( $edac_settings_tab_items ) {
echo '<nav class="nav-tab-wrapper" aria-label="Settings Tabs">';
echo '<nav class="nav-tab-wrapper" aria-label="Settings">';

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.

medium

The aria-label value "Settings" is a user-facing string (read by screen readers) but is currently hardcoded in English. To support internationalization (i18n), it should be translatable using WordPress translation functions like esc_attr__().

        echo '<nav class="nav-tab-wrapper" aria-label="' . esc_attr__( 'Settings', 'accessibility-checker' ) . '">';

@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 `@partials/settings-page.php`:
- Line 115: The landmark label in the settings navigation is hardcoded, so
localize the aria-label in the settings-page markup. Update the echo that
renders the nav-tab-wrapper in the settings page to use esc_attr__() with the
accessibility-checker text domain, keeping the same “Settings” label but making
it translatable and properly escaped.
🪄 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5c6e553b-f841-41f2-a77b-7234ba4bab19

📥 Commits

Reviewing files that changed from the base of the PR and between 27c4c59 and 8ce633e.

📒 Files selected for processing (1)
  • partials/settings-page.php

Comment thread partials/settings-page.php Outdated
Amber suggested this label on issue #1756 instead of the generic
"Settings".
Wrap the aria-label in esc_attr__() with the accessibility-checker
text domain instead of a hardcoded string.
@SteveJonesDev
SteveJonesDev merged commit cf46ebb into develop Jul 5, 2026
18 checks passed
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.

Navigation Landmark Uses an Inaccurate Accessible Name

1 participant