Axon 911 Frontend DocsAxon 911 Frontend Docs
Axon 911 Frontend Docs
    Loading navigation…
U
User
Switch to light mode
  1. Primitives
  2. Scrollable
  3. Accessibility

Scrollable

Accessibility

Accessible scrollable containers ensure all users can navigate content effectively, regardless of input method or assistive technology.
Keyboard Support
Scrollable containers support standard keyboard scrolling.
Scrolling
Users can scroll content using keyboard.
  • Arrow Keys: Scroll content in the direction of the arrow
  • Page Up/Page Down: Scroll by page
  • Home/End: Scroll to beginning or end
  • Space: Scroll down (when focused)
  • Shift + Space: Scroll up (when focused)
Focus Management
Focus moves appropriately within scrollable content.
Focusable elements within scrollable content remain keyboard accessible, and focus moves with content as users scroll.
ARIA Attributes
Scrollable containers use appropriate ARIA attributes when needed.
Scrollable Regions
Scrolling areas are properly identified.
Use role="region" and aria-label when the scrollable area represents a significant page region.
Live Regions
Use live regions for dynamic content updates.
For content that updates dynamically (like chat feeds), use role="log" or role="status" with appropriate aria-live values.
Screen Reader Support
Scrollable containers are accessible to screen reader users.
Content Announcements
Screen readers announce scrollable content appropriately.
Screen readers navigate through scrollable content naturally, announcing content as users scroll or navigate with keyboard.
Scroll Position
Screen readers communicate scroll position when relevant.
Use aria-posinset and aria-setsize for list items to communicate position within the scrollable list.
Focus Management
Ensure focus remains manageable within scrollable content.
Focus Visible
Ensure focus indicators remain visible during scrolling.
Focus indicators remain visible as users scroll, ensuring keyboard navigation remains clear.
Auto-Scroll on Focus
Content scrolls into view when focused elements receive focus.
When focus moves to elements within scrollable content, browsers automatically scroll focused elements into view.
Scrollbar Accessibility
Ensure scrollbars remain accessible when visible.
Scrollbar Visibility
Scrollbars provide visual feedback about scroll position.
Visible scrollbars help users understand content length and current position, improving navigation for all users.
Custom Scrollbars
Custom scrollbars maintain accessibility.
Small scrollbars remain keyboard accessible and provide appropriate visual feedback.
Screen Reader Testing
Test scrollable containers with screen readers to ensure proper navigation.
Expected Behavior
Expected behavior:
  • Screen readers navigate through content normally
  • All content is accessible via keyboard navigation
  • Scrollbars don't interfere with content navigation
  • Focus moves correctly within scrollable area
Dynamic Content
Expected behavior:
  • New content added to the bottom is announced
  • Screen readers receive updates when content changes
  • Scroll position updates are communicated appropriately
Previous
Scrollable / API and Development
Next
Separator / Usage
On this page
Keyboard Support
Scrolling
Focus Management
ARIA Attributes
Scrollable Regions
Live Regions
Screen Reader Support
Content Announcements
Scroll Position
Focus Management
Focus Visible
Auto-Scroll on Focus
Scrollbar Accessibility
Scrollbar Visibility
Custom Scrollbars
Screen Reader Testing
Expected Behavior
Dynamic Content