Clip Path Slider creates a controlled visual sequence: shape masks reveal each slide.
Use it for equal-weight images, portfolio work, campaign visuals, or product shots where browsing is the point. If users must compare everything, read everything, or convert from every item, use a grid instead.
The production risk is hiding important content. Keep controls visible, support keyboard and swipe, announce meaningful slide changes politely, and pause autoplay when the visitor interacts.
Use this as carousel-pattern implementation guidance. Verify the shipped controls, swipe behavior, keyboard model, autoplay/pause behavior, focus management, aria-live announcements, and fallback layout before relying on exact props, defaults, imports, or installation steps.
Best Used For
Portfolio and campaign showcases where shape masks are part of the art direction.
Equal-weight visual slides with visible controls, swipe, and a non-carousel fallback for critical proof.
Clip Path Slider supports visual browsing when a grid would feel flat and comparison is not the priority.
Not For
Not for critical proof, pricing, feature comparisons, or content users must see to convert.
Performance Budget
Optimize images, lazy-load offscreen slides carefully, and pause autoplay when inactive or offscreen.
Accessibility and Mobile
Use visible controls, keyboard navigation, swipe, and aria-live="polite" for meaningful slide changes. Mobile controls must remain reachable.
Common Mistakes
Using Clip Path Slider to hide critical conversion content.
Autoplaying without pause controls.
Skipping keyboard and swipe support.
Changelog
v1.0.1
Jul 28, 2026
Added reduced-motion support and exposed slides, clueText, and cursor styling as public props.
v1.0.0
Jun 4, 2026
Initial release
Props
Prop
Type
Default
Description
showClue
boolean
true
Shows the instructional clue text above the slider.
cursorBg
color
#ff5f00
Background color of the custom directional cursor.
cursorLineColor
color
#ffffff
Color of the arrow lines inside the custom cursor.
duration
number
0.75
Clip-path transition duration.
Frequently Asked Questions
When should I use Clip Path Slider?
Use it when users browsing equal-weight visuals need shape masks revealing each slide.
Should Clip Path Slider autoplay?
Only with pause controls and only if autoplay stops on hover, focus, touch, and reduced motion.
How should Clip Path Slider announce slides?
Use a labelled region and aria-live="polite" for meaningful user-initiated changes.
When is a grid better than Clip Path Slider?
Use a grid when users need to compare, scan, read, or see all items to convert.
How should Clip Path Slider behave on mobile?
Support swipe, keep controls reachable, and reduce depth or masking where it hurts clarity.