A list of titles that turns along an arc beside an image preview
| Name | Type | Default | Description |
|---|---|---|---|
items | ArcListItem[] | 10 sample artworks | Entries to list. Each takes a title, plus an optional image, alt text, subtitle and href. Clicking the active entry, or pressing Enter, opens its href. |
startIndex | number | 0 | Entry selected on mount. |
orientation | "auto" | "vertical" | "horizontal" | "auto" | Vertical bends the list beside the image. Horizontal lays it along an arc under the image, swiped sideways so it never blocks page scrolling. Auto switches to horizontal when the container is narrower than 640px. |
imageSide | "left" | "right" | "none" | "left" | Where the image sits next to a vertical list, or none for a list on its own. A horizontal list always sits under the image. |
curve | number | 0.5 | How strongly the list bends around the arc, from 0 (a straight list) to 1. |
spacing | number | 76 | Distance between titles in a vertical list, in pixels. A horizontal list spaces titles by their own width plus a gap derived from this value. |
visible | number | 3 | How many titles show on each side of the active one. Titles always fade out smoothly before they reach an edge or the image. |
fade | number | 0.35 | How quickly titles fade with distance, from 0 to 1. |
shrink | number | 0.1 | How much distant titles shrink, from 0 to 1. |
blur | number | 0 | Blur applied to the most distant titles, in pixels. |
fontSize | number | 30 | Title size in pixels. Small containers scale it down. |
fontWeight | number | 600 | Title weight. The font itself is inherited from the page. |
textColor | string | "#737373" | Colour of the titles, subtitles and indicator. |
activeColor | string | "#B19EEF" | Colour the active title fills with. With autoplay it fills from left to right as a timer. |
backgroundColor | string | "transparent" | Background of the root element. |
indicator | boolean | true | Show the small arrow that marks the active slot. |
subtitles | boolean | true | Show the active entry's subtitle under its title. |
autoplay | boolean | true | Move to the next entry on a timer. Users who prefer reduced motion never get autoplay. |
interval | number | 3.5 | Seconds each entry stays active during autoplay. |
pauseOnHover | boolean | true | Hold the autoplay timer while the pointer is over the component. |
loop | boolean | true | Wrap around from the last entry to the first. When off, the list stops at both ends and scrolling past them scrolls the page. |
wheel | boolean | true | Turn the list with the mouse wheel or trackpad. One notch moves one entry. Set it to false to leave page scrolling untouched. |
draggable | boolean | true | Turn the list by dragging it up and down, with momentum. Works with touch. |
smoothing | number | 0.45 | How long the list takes to glide into place, in seconds. |
inertia | number | 0.6 | How far a flick carries the list, from 0 to 1. |
imageWidth | number | 340 | Maximum width of the image in pixels. |
imageAspect | number | 0.78 | Width divided by height for the image frame. |
imageRadius | number | 14 | Corner radius of the image frame in pixels. |
gap | number | 64 | Space between the image and the list in pixels. |
transition | "blur" | "fade" | "slide" | "blur" | How images change. The transition follows the list as it turns, so dragging slowly scrubs between two images. |
imageBlur | number | 18 | Blur radius in pixels at the midpoint of the "blur" transition. |
onChange | (index, item) => void | — | Called when the active entry changes. |
onSelect | (index, item) => void | — | Called when the active entry is clicked or chosen with Enter. |
ariaLabel | string | "Projects" | Accessible name of the list. |
ref | { next, previous, goTo } | — | Turn the list from code. goTo(index) takes the shortest way round. |
className | string | — | Classes for the root element. It fills its parent, with a 360px minimum height. |
style | CSSProperties | — | Inline styles for the root element. |
itemsArcListItem[]Entries to list. Each takes a title, plus an optional image, alt text, subtitle and href. Clicking the active entry, or pressing Enter, opens its href.
10 sample artworksstartIndexnumberEntry selected on mount.
0orientation"auto" | "vertical" | "horizontal"Vertical bends the list beside the image. Horizontal lays it along an arc under the image, swiped sideways so it never blocks page scrolling. Auto switches to horizontal when the container is narrower than 640px.
"auto"imageSide"left" | "right" | "none"Where the image sits next to a vertical list, or none for a list on its own. A horizontal list always sits under the image.
"left"curvenumberHow strongly the list bends around the arc, from 0 (a straight list) to 1.
0.5spacingnumberDistance between titles in a vertical list, in pixels. A horizontal list spaces titles by their own width plus a gap derived from this value.
76visiblenumberHow many titles show on each side of the active one. Titles always fade out smoothly before they reach an edge or the image.
3fadenumberHow quickly titles fade with distance, from 0 to 1.
0.35shrinknumberHow much distant titles shrink, from 0 to 1.
0.1blurnumberBlur applied to the most distant titles, in pixels.
0fontSizenumberTitle size in pixels. Small containers scale it down.
30fontWeightnumberTitle weight. The font itself is inherited from the page.
600textColorstringColour of the titles, subtitles and indicator.
"#737373"activeColorstringColour the active title fills with. With autoplay it fills from left to right as a timer.
"#B19EEF"backgroundColorstringBackground of the root element.
"transparent"indicatorbooleanShow the small arrow that marks the active slot.
truesubtitlesbooleanShow the active entry's subtitle under its title.
trueautoplaybooleanMove to the next entry on a timer. Users who prefer reduced motion never get autoplay.
trueintervalnumberSeconds each entry stays active during autoplay.
3.5pauseOnHoverbooleanHold the autoplay timer while the pointer is over the component.
trueloopbooleanWrap around from the last entry to the first. When off, the list stops at both ends and scrolling past them scrolls the page.
truewheelbooleanTurn the list with the mouse wheel or trackpad. One notch moves one entry. Set it to false to leave page scrolling untouched.
truedraggablebooleanTurn the list by dragging it up and down, with momentum. Works with touch.
truesmoothingnumberHow long the list takes to glide into place, in seconds.
0.45inertianumberHow far a flick carries the list, from 0 to 1.
0.6imageWidthnumberMaximum width of the image in pixels.
340imageAspectnumberWidth divided by height for the image frame.
0.78imageRadiusnumberCorner radius of the image frame in pixels.
14gapnumberSpace between the image and the list in pixels.
64transition"blur" | "fade" | "slide"How images change. The transition follows the list as it turns, so dragging slowly scrubs between two images.
"blur"imageBlurnumberBlur radius in pixels at the midpoint of the "blur" transition.
18onChange(index, item) => voidCalled when the active entry changes.
—onSelect(index, item) => voidCalled when the active entry is clicked or chosen with Enter.
—ariaLabelstringAccessible name of the list.
"Projects"ref{ next, previous, goTo }Turn the list from code. goTo(index) takes the shortest way round.
—classNamestringClasses for the root element. It fills its parent, with a 360px minimum height.
—styleCSSPropertiesInline styles for the root element.
—