Prepared Docs

Prepared Docs

⌘K

    Loading navigation…

User

  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