MTtankkeo/web_touch_ripple

Use web components to implement simple touch ripple effects.

Touch Ripple For Web

Use web components to implement efficient and simple and flexible touch ripple effects.

Preview

This is just a preview of a simple example of that package.

This may be different from the real thing (by gif)

How to apply ripple element

Please refer to the following codes for details!

Staticly

This is a solution of converting a string into a function and using it.

Not recommended to use it in this way and it can mainly be used for debugging purposes.

<!-- Called when a user taps or clicks. -->
<touch-ripple ontap="console.log('tap!')">
    <!-- child of the touch-ripple element must be one. -->
    <h1 style="padding: 15px;">
        Hello, world!
    </h1>
</touch-ripple>

Locally

This is the most ideal and widely used solution.

<touch-ripple id="ripple">...</touch-ripple>
<script>
    // in script.
    const ripple = document.getElementById("ripple");

    // Called when a user taps or clicks.
    ripple.ontap = () => console.log("tap!");

    // Called when a user double taps or clicks.
    ripple.ondoubletap = () => console.log("double tap!");

    // Called when a user long press or long clicks or long pointer-down.
    ripple.onlongtap = () => console.log("long tap!");
</script>

How to wait callback until ripple effects are spread all?

This is can implement by adding a attribute wait to a touch-ripple element.

<!-- Called when a ripple effect has spread all, after a user taps and clicks. -->
<touch-ripple ontap="() => ..." wait>

How to use with react in typescript?

This is can easily implement this by adding import like the code below.

import "web-touch-ripple";
import { TouchRipple } from "web-touch-ripple/jsx";

export function TestPage() {
    return (
        <TouchRipple onTap={() => console.log("tap!")}>
            <h1>Hello, world!</h1>
        </TouchRipple>
    );
}

Static variables of CSS

Name	Description	Default Value
--ripple	The background color of touch-ripple effect.	rgba(0, 0, 0, 0.2)
--ripple-hover	The background color of touch-ripple effect when the hover state.	rgba(0, 0, 0, 0.1)
--ripple-hover-duration	This is duration of fade-in or fade-out about the hover effect.	0.25s
--ripple-fadein-duration	The duration until the ripple effect completely fills the element.	0.25s
--ripple-fadein-curve	This is curve about fade-in and spread animation of ripples.	cubic-bezier(.2,.3,.4,1)
--ripple-fadeout-duration	The duration until the ripple effect disappears.	0.4s
--ripple-fadeout-curve	This is curve about fade-out animation of ripples.	default of browser
--ripple-cancel-duration	This is curve about fade-out animation of ripples when cancels.	0s
--ripple-cancel-curve	This is curve about fade-out animation of ripples when cancels.	default of browser
--ripple-blur-radius	The blur effect radius of touch ripple.	15px
--ripple-lower-scale	The ripple scale of start point.	0.3
--ripple-upper-scale	The ripple scale of end point.	1
--ripple-tap-preview-duration	The rejectable duration about tap event.	0.15s
--ripple-tappable-duration	After a pointer down occurs, gestures are rejected after this duration.	none
--ripple-double-tappable-duration	This duration required to define if it is a double tap.	0.1s
--ripple-overlap-behavior	This option defines the behavior of a touch ripple when it overlaps. (overlappable, cancel, ignoring)	overlappable
--ripple-use-hover	Whether or not to apply the hover effect.	1 (true)

How to customize gestures?

Use the Gesture Arena and Gesture Recognizer provide on this package.

// for gestures competition for accept on the place.
this.arena = new GestureArena();

// for factory function registering about the gesture-recognizer.
this.arena.registerBuilder(() =>
    new TapGestureRecognizer(...args)
);

How to make gesture recognizer?

Please refer to the following codes for details!

// in `gesture_recognizer.ts`
export class TouchRippleGestureRecogzier extends GestureRecognizer { ... }

// e.g.
export class TestGestureRecognizer extends TouchRippleGestureRecogzier {
    constructor(
        public callback1: GestureEventCallback,
        public callback2: GestureEventCallback,
        public callback3: GestureEventCallback,
    ) {
        super();
    }

    pointerDown(position: PointerPosition): void { ... }
    pointerMove(positoin: PointerPosition): void { ... }
    pointerUp(positoin: PointerPosition): void { ... }
    pointerCancel(positoin: PointerPosition): void { ... }

    dispose(): void {
        // Defines all values defined for judgment as null.
    }

    onAccept(): void { ... }
    onReject(): void { ... }
}