Skip to content

Conversation

@sokn-sys
Copy link
Contributor

@sokn-sys sokn-sys commented Sep 17, 2025

COMPLETES #< https://jira-eng-gpk2.cisco.com/jira/browse/SPARK-564419>

This pull request addresses

The base @webex/components WebexMeeting widget, as shown in storybook, does not fully support accessibility requirements. When navigating via keyboard, focus escapes instead of moving into the meeting controls. Additionally, the video layout is not focusable, and left/right arrow key navigation between button controls is not supported.
To meet FCC accessibility expectations, we have implemented a custom fix in our widget repo to handle focus redirection, make video layouts focusable, and enable arrow key navigation. This represents the possible fix we can provide on our side until the shared component library addresses these gaps.
we must remove this custom code from our repo to avoid duplication and ensure long-term maintainability.

by making the following changes

  • Added custom focus handling so focus goes to the first control (Join Meeting ) instead of escaping.
  • Made the video layout section focusable with ARIA support for screen readers.
  • Enabled left/right arrow key navigation between button controls
  • Added a fallback to stop focus from jumping to the browser URL bar

##Vidcast
https://app.vidcast.io/share/d825117b-f92e-4948-af29-032ef3364de3

Change Type

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update
  • Tooling change
  • Internal code refactor

The following scenarios were tested

  • The testing is done with the amplify link
    < ENUMERATE TESTS PERFORMED, WHETHER MANUAL OR AUTOMATED >

The GAI Coding Policy And Copyright Annotation Best Practices

  • GAI was not used (or, no additional notation is required)
  • Code was generated entirely by GAI
  • GAI was used to create a draft that was subsequently customized or modified
  • Coder created a draft manually that was non-substantively modified by GAI (e.g., refactoring was performed by GAI on manually written code)
  • Tool used for AI assistance (GitHub Copilot / Other - specify)
    • Github Copilot
    • Other - Please Specify
  • This PR is related to
    • Feature
    • Defect fix
    • Tech Debt
    • Automation

Checklist before merging

  • I have not skipped any automated checks
  • All existing and new tests passed
  • I have updated the testing document

Copy link
Contributor

@adhmenon adhmenon left a comment

Choose a reason for hiding this comment

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

Changes are working from vidcast... just have few doubts on the implementation method.

Copy link
Contributor

@adhmenon adhmenon left a comment

Choose a reason for hiding this comment

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

Let us create a ticket to update this logic once the components changes are done.
We should only add this as a workaround.

@sokn-sys sokn-sys merged commit 766a646 into webex:master Oct 8, 2025
1 check passed
@mkesavan13
Copy link
Contributor

🎉 This PR is included in version 1.28.2 🎉

The release is available on:

Your semantic-release bot 📦🚀

pull bot pushed a commit to Zezo-Ai/ZezoAi-webex-widgets that referenced this pull request Oct 22, 2025
## [1.28.2](webex/widgets@v1.28.1...v1.28.2) (2025-10-22)

### Bug Fixes

* **meeting-widget:** add custom focus management and arrow key navigation ([webex#533](webex#533)) ([766a646](webex@766a646))
* **Meeting Widget:** stop screen readers focusing on visually hidden controls ([webex#532](webex#532)) ([d728896](webex@d728896))
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants