React Reference > ons-ripple Component

<ons-ripple />

Adds a Material Design “ripple” effect to an element. The ripple effect will spread from the position where the user taps. Some elements such as <ons-button> and <ons-fab> support a ripple attribute.

Tutorial

Ripple

The Ripple component is used to add a Material Design ripple effect to an element. This effect will expand from the location point the user taps until it covers the whole element.

To add a ripple effect to an element the Ripple component should be placed as a child.

<div style={{width: 100, height: 100, backgroundColor: 'grey'}}>
  <Ripple />
</div>

The color of the ripple effect defaults to gray. It can be customized using the color property. It is also possible to customize the background color with the background property.

<Ripple color='red' background='blue' />

The ripple prop

There are some components that support the ripple effect using a ripple property. The Button component is one of those. In this case, instead of using the Ripple component only the property ripple needs to be added:

<Button ripple>
  Ripple!
</Button>

Other components that support the ripple property are: ListItem, Fab, SpeedDial and Tab.

See also

Attributes

[improve this]
Name Type Description
color String Color of the ripple effect. Optional.
modifier String The appearance of the ripple effect. Optional.
background String Color of the background. Optional.
size String Sizing of the wave on ripple effect. Set “cover” or “contain”. Default is “cover”. Optional.
center Boolean If this attribute presents, change the position of wave effect to center of the target element. Optional.
disabled If this attribute is set, the ripple effect will be disabled. Optional.

Properties

[improve this]
Name Description
center If this attribute presents, change the position of wave effect to center of the target element.
disabled Whether the element is disabled or not.

Preset Modifiers

[improve this]
Name Description
light-gray Change the color of effects to light gray.

Need Help?

If you have any questions, use our Community Forum or talk to us on Discord chat. The Onsen UI team and your peers in the community will work together to help solve your issues.

For bug reports and feature requests use our GitHub Issues page.