A slideshow where each photo takes over with a diagonal, soft-edged wipe. Includes arrows, dots, auto-advance and keyboard control.
Algarve in October
4 photos
npx shadcn@latest add https://hyperblur.dev/r/image-wipe-slider.jsonWorks in any React project set up with the shadcn CLI. The file lands in components/hyperblur/image-wipe-slider.tsx.
import { ImageWipeSlider } from "@/components/hyperblur/image-wipe-slider"
<ImageWipeSlider images={["/a.jpg", "/b.jpg", "/c.jpg"]} alt="Trip photo" />| Prop | Type | Default | Description |
|---|---|---|---|
| images | string[] | Image URLs. When empty or missing, four built-in gradient and SVG scenes are used. | |
| alt | string | "Photo" | Base accessible name. Each slide is announced as the alt text followed by its position, for example Photo 2 of 4. |
| width | number | string | "100%" | CSS width of the component. |
| height | number | string | CSS height. When omitted the height follows `aspect`. | |
| aspect | string | "16 / 10" | CSS aspect-ratio used when `height` is not set. |
| index | number | Controlled slide index. Pair with onChange. | |
| defaultIndex | number | 0 | Initial slide index when uncontrolled. |
| onChange | (index: number) => void | Called with the new slide index after every change, including automatic ones. | |
| autoPlay | boolean | true | Advance on a timer. It pauses on hover, keyboard focus and while off-screen, and stays off under reduced motion. |
| interval | number | 3200 | Milliseconds between automatic changes. |
| duration | number | 900 | Wipe duration in milliseconds. |
| accent | string | "#2f7bff" | Color of focus rings and highlights. |