Ripple Distortion

Effects

Pointer impulses send expanding waves through a textured print.

React · copy into your project · light and dark themes

Try it

Variant

Move or tap the print to send a ripple through it. The image itself bends as the wave travels.

Loading preview…

Take it with you

Copy the example, API and usage notes for your editor or AI assistant.

Add to your project

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/ripple-distortion.json

The command includes the component’s shared dependencies. Your project keeps editable source files.

Include the complete example

This example also composes button. Install its parts together:

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/button.json https://luv-jeri.github.io/cojeev-ui/r/ripple-distortion.json

Using ripple distortion

Optional material playground; keep important text outside.
The example runs locally. Supply your own content; keep essential reading outside decorative paint.

API

Compose the exported parts below. The prop types are read from the React source during the registry build.

Native element or underlying primitive props are inherited where declared, including accessible labels, event handlers and refs.

RippleDistortionProps

Prop	Type	Required
`paused` Stop movement while retaining a composed, meaningful still frame.	`boolean`	No
`tone`	`"pink" \| "olive" \| "blue" \| "yellow"`	No
`speed`	`number`	No
`count`	`number`	No
`height` Height of the local effect stage, in CSS pixels.	`number`	No
`src` Optional texture for the elastic sheet or ripple.	`string`	No
`images` Optional image cards for the trail. Decorative; describe their subject nearby.	`readonly string[]`	No

Accessibility

Respects reduced motion, Motion Off and Flow Off. Optional motion stops while hidden or outside the viewport.
Native cursor, keyboard focus and vertical touch scrolling remain available.

States and appearance

restactivepausedreduced-motion

For conditional content, keep a MotionPresence boundary around keyed MotionSurface children. The shared entrance and exit states work with native primitives and respect your motion preference.

Try pointer and keyboard interaction, and switch the appearance control in the navigation to compare light and dark mode. Motion respects reduced motion preferences.