Skip to content

docs(spec): define keyboard-reachable scroll containers - #5979

Closed
cixzhang wants to merge 1 commit into
mainfrom
docs/scrollable-tab-stop-spec
Closed

docs(spec): define keyboard-reachable scroll containers#5979
cixzhang wants to merge 1 commit into
mainfrom
docs/scrollable-tab-stop-spec

Conversation

@cixzhang

@cixzhang cixzhang commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Why

Keyboard users cannot reach an Astryx-owned scroll container when it overflows but contains no visible sequential-focus control. PR #5553 adds a shared public solution, but no current accessibility contract owns when that fallback stop should exist. The BottomSheet draft also still says focus behavior is unchanged.

What

  • Adds draft system spec AST-019 for keyboard-reachable scroll containers: actual per-axis scrollability, descendant ownership, focus stability, author-owned tabindex, visible focus, naming, resource bounds, and browser evidence.
  • Keeps assistive-technology verification with AST-009: ordinary Tab order and keyboard scrolling require real-browser evidence, not a real-AT matrix unless the change makes an AT-specific claim.
  • Links the BottomSheet draft contract to AST-019 and projects the proposed behavior and verification from fix(core): make text-only Bottom Sheets keyboard-scrollable #5553.

Ordering

This is the proposed shared contract below implementation PR #5553. It remains draft until an authorized owner approves the two decisions and promotes it to current; #5553 should then be reconciled with the accepted exact head.

Validation

  • Astryx CLI bootstrap and astryx component BottomSheet --dense
  • pnpm check:knowledge -- --base origin/main
  • Prettier
  • git diff --check

No Changeset: specification records only.

@vercel

vercel Bot commented Sep 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
astryx Ready Ready Preview Sep 3, 2026 6:42pm UTC

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Sep 3, 2026
@cixzhang

cixzhang commented Sep 4, 2026

Copy link
Copy Markdown
Contributor Author

Closing at the author's request.

@cixzhang cixzhang closed this Sep 4, 2026
@github-actions
github-actions Bot deleted the docs/scrollable-tab-stop-spec branch September 5, 2026 06:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant