@smui/ripple

Svelte Material UI - Ripple

Ripples are an interaction feedback mechanism.

Installation

npm install --save-dev @smui/ripple

Demo

See it in action.

See the demo code.

Basic Usage

If you don't have a `class` attribute:

<p use:Ripple tabindex="0">Here is an element with a ripple.</p>

If you do have a `class` attribute:

<p
  class="some-class {Object.keys(rippleClasses).join(' ')}"
  use:Ripple={{
    addClass: (className) => (rippleClasses[className] = true),
    removeClass: (className) => {
      delete rippleClasses[className];
      rippleClasses = rippleClasses;
    },
  }}
  tabindex="0"
>
  Here is an element with a ripple.
</p>

<script>
  import Ripple from '@smui/ripple';

  let rippleClasses = {};
</script>

Exports

(default)

A ripple Svelte action.

Props / Defaults

The action accepts an array, with two entries. The first is a boolean, whether the ripple is enabled. The second is an object with the props:

• ripple: true - Whether to enable the ripple.
• surface: false - Whether the ripple surface classes should be added.
• unbounded: false - Whether the ripple is unbounded.
• disabled: false - Whether the node is disabled.
• color: null - The ripple color. ('surface', 'primary', or 'secondary')
• active: null - Used to determine active status of the ripple. If it's null, the ":active" pseudo class will be checked on activeTarget or the node.
• eventTarget: null - An alternate element where ripple triggering event listeners will be added.
• activeTarget: null - An alternate element where active status will be checked.
• addClass: (className) => node.classList.add(className) - A function to add a class to the node.
• removeClass: (className) => node.classList.remove(className) - A function to remove a class from the node.
• addStyle: (name, value) => node.style.setProperty(name, value) - A function to add a style property to the node. If given a value of '' or null, it should remove the property.
• initPromise: Promise.resolve() - A promise to wait for before initializing the ripple.

More Information

See Ripple in MDC-Web for information about the upstream library's architecture.

Changelog

3.0.0-beta.9 (2021-04-16)

Bug Fixes

• focus indicator on keyboard focus checkbox and switch (219d146)
• menu surface anchor adds classes with default function (27f5a16)
• non-interactive chip text color (e673c93)
• primary action span missing from chips (17758af)
• remove more event forwarding declarations (17165ce)
• remove Slider highlight color on tap in Chrome (3ccb603), closes #219
• use passive listener on tooltip window scroll (377de62)

Features

• add nonInteractive chip set feature and fix chip tabindex management (c1f223f)
• new Tooltip component (6293aef)