Sketchbook
On this page

Tag <sb-scroll-area> · status stable · version 0.1.0

Example

Entry 1
Entry 2
Entry 3
Entry 4
Entry 5
Entry 6
Entry 7
Entry 8
Entry 9
Entry 10
<sb-scroll-area label="Release notes" style="display:block;height:200px;width:240px">
  <div style="padding:8px 0">Entry 1</div>
  <div style="padding:8px 0">Entry 2</div>
  <div style="padding:8px 0">Entry 3</div>
  <div style="padding:8px 0">Entry 4</div>
  <div style="padding:8px 0">Entry 5</div>
  <div style="padding:8px 0">Entry 6</div>
  <div style="padding:8px 0">Entry 7</div>
  <div style="padding:8px 0">Entry 8</div>
  <div style="padding:8px 0">Entry 9</div>
  <div style="padding:8px 0">Entry 10</div>
</sb-scroll-area>

Properties

Name Type Default Notes
label text `` Accessible name of the scrollable region. Required for a good experience: it names the focus stop that keyboard users land on.

Parts

<sb-scroll-bar>

Declares which axis the scroll area scrolls on. The scrollbar itself is native; this element only switches the axis on.

Name Type Default Notes
orientation vertical, horizontal vertical The axis to enable. A scroll area with no sb-scroll-bar scrolls vertically; with some, it scrolls on exactly the axes they name.

Keyboard

Key Does
Tab focus the viewport while it can scroll
ArrowUp scroll up (native)
ArrowDown scroll down (native)
ArrowLeft scroll left (native)
ArrowRight scroll right (native)
PageUp scroll one page up (native)
PageDown scroll one page down (native)
Home scroll to the start (native)
End scroll to the end (native)

Accessibility

  • Role: region while scrollable, otherwise none
  • Accessible name: label prop. Without a label the viewport stays focusable but is not exposed as a region, and a console warning fires once per element.

View as Markdown