You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Please do not close this bug. This bug should only be closed by TCS, C+AI Accessibility tester after bug verification.
"Check out Accessibility Insights! - Identify accessibility bugs before check-in and make bug fixing faster and easier."
Bypass Blocks – "Skip to main content" link missing
User Experience:
Keyboard and screen reader users are forced to tab through every repeated element (header, navigation, menus) on the home screen before reaching the primary content. This creates significant navigation overhead, increases fatigue, and slows down access to meaningful information on every visit to the page.
The “Skip to main content” link/button is not present on the Typespec page. This link is essential for keyboard and screen reader users to quickly navigate to the main content without tabbing through repetitive navigation elements.
Expected Result:
A visible “Skip to main content” link should be available at the top of the page and should receive keyboard focus, allowing users to skip directly to the main content.
How to Fix:
Add a skip link as the first focusable element inside , for example: Skip to main content. Ensure the target container has a matching id and is focusable (e.g.,
). Style the link so it is visually hidden by default but becomes visible when it receives keyboard focus (do not use display:none or visibility:hidden, as these remove it from the tab order). Verify with keyboard-only navigation that the link appears on first Tab, and that activating it shifts focus and scroll position to the main content.
Environment details:
Application Name: TypeSpec
URL: typespec.io
Edition Windows 11 Enterprise
Version 25H2 OS build 26200.8390
Chrome Version 148.0.7778.168 (Official Build) (64-bit)
Please do not close this bug. This bug should only be closed by TCS, C+AI Accessibility tester after bug verification.
"Check out Accessibility Insights! - Identify accessibility bugs before check-in and make bug fixing faster and easier."
GitHub Tags:
#A11yTCS; A11yMAS; #A11ySev2; #DesktopWeb; #Win11; #Chrome; # E2E_TypeSpec_Web_May2026; #WCAG2.4.1; #Bypass Block; # TypeSpec;
Issue Subcategory:
Bypass Blocks – "Skip to main content" link missing
User Experience:
Keyboard and screen reader users are forced to tab through every repeated element (header, navigation, menus) on the home screen before reaching the primary content. This creates significant navigation overhead, increases fatigue, and slows down access to meaningful information on every visit to the page.
Repro Steps:
Launch url typespec.io> Typespec page.
Actual Result:
The “Skip to main content” link/button is not present on the Typespec page. This link is essential for keyboard and screen reader users to quickly navigate to the main content without tabbing through repetitive navigation elements.
Expected Result:
A visible “Skip to main content” link should be available at the top of the page and should receive keyboard focus, allowing users to skip directly to the main content.
How to Fix:
Add a skip link as the first focusable element inside , for example: Skip to main content. Ensure the target container has a matching id and is focusable (e.g.,
). Style the link so it is visually hidden by default but becomes visible when it receives keyboard focus (do not use display:none or visibility:hidden, as these remove it from the tab order). Verify with keyboard-only navigation that the link appears on first Tab, and that activating it shifts focus and scroll position to the main content.Environment details:
Application Name: TypeSpec
URL: typespec.io
Edition Windows 11 Enterprise
Version 25H2 OS build 26200.8390
Chrome Version 148.0.7778.168 (Official Build) (64-bit)
Attachment:
A11y_Typespec_Bypass.Blocks.mp4