Token Catalog

Carousel motion

Investigating carousel stutter and overscroll on iOS.

When a Material Design 3 carousel settles after a drag, some implementations pause and step as they slow down, while others overshoot before snapping back. V5 (the current baseline) is smooth on desktop; the remaining touch issues happen on iPhone and iPad.

Three close-ups of the card’s right edge at 0.450, 0.500 and 0.550 seconds. The first two edges align; the third moves three recording pixels to the right.
The card edge holds for 50 ms, then jumps three recording pixels.

Playground

Pick an implementation, drag or flick the carousel, and record the interaction to export its motion data as JSON.

Loading experiment…

Recording

Start recording, drag the carousel, and stop once it settles.

Loading recorder…

Up to five recordings stay in this tab while you switch settings. Download them before reloading or closing the tab. Recording stops automatically after 60 seconds or if you switch tabs.

What’s recorded?

Browser and display metadata, input events, frame timestamps, native scroll offsets, and assigned CSS values. Everything stays in your browser; nothing is uploaded.

Pair the JSON export with a screen recording to compare assigned CSS values against rendered frames.

Implementation history

VersionChangeObserved result
V1 · Original native scrollingNative smooth scrolling with queued geometry updates.Stutters on desktop and iOS.
V2 · MD3-timed settlingMD3-timed settling, transform positioning, and native scroll writes each frame.Still rough while settling.
V3 · Synchronized visual settlingFractional settling and artwork offsets; syncs native scroll on completion.Smoother on desktop; touch still jitters and stutters.
V4 · Boundary clampingAdds boundary clamping, layout containment, and compositor hints.Less directional jitter; settling still stutters.
V5 · Current baselineSticky track and boundary clamping without layout hints.Smooth on desktop; touch settling still steps on iOS.
V6 · Fixed masksFixed mask widths and artwork offsets driven by scroll position.Stutters, with visible gaps and overlaps.
V7 · Native-flow controlFixed-width cards in normal flow.Smoother on iOS; desktop scroll-wheel settling still steps.
V8 · Whole-pixel settlingRounds positions to whole pixels during custom settling.Smooth mouse release on desktop (reference target for iOS).
V9 · Custom touch settlingNative dragging followed by fractional JavaScript settling at release.Smoother initial release, but triggers late corrections and boundary overscroll.

Stutter and overscroll

Recorded traces and annotated clips showing settling pauses, late position corrections, and boundary overscroll on iOS.

Release traces

Time 0 ms is the release event (touchend on iOS, pointerup on PC, or the arrow-button click for V7 on PC). The reference curve shows 300 ms MD3 standard easing from the position at release.

Target · 300 ms MD3CSS positionScroll offset

V8 · Whole-pixel settling · desktop target

V8 matches V5 on desktop, with only a brief two-frame hold. This is the settling quality to match on iOS. View hold summary

V1 · Original native scrolling · iOS

Return, forward, and backward swipes on iOS. Settling holds reach 117 ms. View hold summary

V5 · Current baseline · iOS

Same swipes on V5. The slow tail still has holds up to 117 ms. View hold summary

V9 · Custom touch settling · small correction

After reaching item 3, the card edge shifts 16 recording pixels and snaps back. View hold summary

V9 · Custom touch settling · boundary overscroll

The card layer moves past its resting left edge, leaving blank space before returning. View hold summary
V9 custom touch settling: cards before release, shifted far right leaving blank space, and back at the resting left edge.
A slight touch displaces the cards far to the right before they snap back.
V7–V9 · Additional iOS recordings

V7 · Native-flow control · iOS

Fixed-width cards in normal flow. The edge advances in smaller increments during the tail. View hold summary

V8 · Whole-pixel settling · iOS

Touch release still uses native settling here; edge holds reach 117 ms. View hold summary

V9 · Custom touch settling · smooth return

When handoff avoids late corrections, the return settles smoothly with no repeated edge holds. View hold summary
Device results

V5 and V8 are smooth on PC and MacBook Air M4. Touch settling stutter reproduces on iPhone 15, iPhone 13 Pro Max, and iPad Air (5th generation) across Safari, Chrome, Firefox, and Brave.

V7 (native flow) and V9 (custom touch settling) felt smoother initially on iOS, but V9 introduced late corrections and boundary overscroll. Desktop mouse release and V5 touch release use different settling paths.

How the versions differ

The carousel uses HTML cards with inline SVG artwork. Most versions resize each card’s visible mask as the scroll position changes while keeping the artwork at a fixed size.

V5 positions cards inside a sticky track. V7 uses fixed-width cards in normal flow as a control to show how the browser scrolls without masking.

V2–V5 and V8 use 300 ms MD3 standard easing for mouse release and arrow buttons, while iOS swipes settle through native browser scrolling. V9 hands off to JavaScript animation when the finger lifts.

Help fix iOS touch settling

Have a fix or a smaller reproduction? Open a pull request with the change, the version tested, and a before-and-after recording (include browser, device, and input method).

Keep the cards’ changing widths and fixed artwork proportions, and preserve vertical page scrolling, keyboard navigation, and reduced motion.