rua
react-ui-animate
npm i react-ui-animate
rua

react-ui-animate

React library for gestures and animation 💻

by Dipesh Rai

2.0.0 (see all)License:MITTypeScript:Not Found
npm i react-ui-animate
Readme

React UI Animate

npm version

React library for gestures and animation

Install

Install with npm:

npm i react-ui-animate

or Install with yarn:

yarn add react-ui-animate

Getting Started

react-ui-animate provides lots of easy to use APIs to create smooth animations and gestures.

import { AnimatedBlock, useAnimatedValue } from "react-ui-animate";

export default function () {
  const opacity = useAnimatedValue(0); // It initializes opacity object with value 0.

  return (
    <div>
      {/* AnimatedBlock component can read useAnimatedValue() */}
      <AnimatedBlock
        style={{
          opacity: opacity.value, // using opacity with value property
          width: 100,
          padding: 20,
          background: "#39F",
        }}
      >
        ANIMATED
      </AnimatedBlock>

      {/* Assigning value to 1 auto animates from initialized value 0 to 1 smoothly */}
      <button onClick={() => (opacity.value = 1)}>Animate Me</button>
    </div>
  );
}

Animates opacity from 0 to 1.

useAnimatedValue()

useAnimatedValue() is very flexible and powerful hook that lets you define animated values. It accepts a value and returns a node with same value on value property. Whenever value property is assigned to another value, it auto animates from one value to another.

const opacity = useAnimatedValue(0); // initialize with 0 opacity

...
style={{
    opacity: opacity.value // access with `.value`
}}
...

...
onClick={() => opacity.value = 1} // Assignment
...

AnimatedBlock

AnimatedBlock is a div component which can accept the animation node from useAnimatedValue() hook.

const width = useAnimatedValue(100);

<AnimatedBlock
  style={{
    width: width.value,
    height: 100,
    backgroundColor: "#39f",
  }}
/>;

interpolate

The interpolate() function allows animated node value to map from input ranges to different output ranges. By default, it will extrapolate the curve beyond the ranges given, but you can also have it clamp the output value.

import { useAnimatedValue, AnimatedBlock, interpolate } from "react-ui-animate";

const width = useAnimatedValue(100);

<AnimatedBlock
  style={{
    width: width.value,
    height: 100,
    backgroundColor: interpolate(width.value, [100, 200], ["red", "blue"]),
  }}
/>;

backgroundColor is interpolated from input range [100, 200] to output range ["red", "blue"]. So, when the width changes from 100 to 200, backgroundColor will change from red to blue.

Documentation

The official documentation are now published at http://react-ui-animate.js.org/

License

MIT

Downloads/wk

159

GitHub Stars

35

LAST COMMIT

3mos ago

MAINTAINERS

1

CONTRIBUTORS

0

OPEN ISSUES

2

OPEN PRs

0
VersionTagPublished
2.0.0
latest
8d ago
1.4.7
old
9d ago
2.0.0-rc.7
next
16d ago
1.2.0-alpha.4
alpha
8mos ago
No alternatives found
No tutorials found
Add a tutorial