@rc-component/motion

@rc-component/motion

React lifecycle controlled motion library.

Live Demo

https://react-component.github.io/motion/

Install

Example

import CSSMotion from '@rc-component/motion';

export default ({ visible }) => (
  <CSSMotion visible={visible} motionName="my-motion">
    {({ className, style }) => <div className={className} style={style} />}
  </CSSMotion>
);

API

CSSMotion

Property	Type	Default	Description
motionName	string	-	Config motion name, will dynamic update when status changed
visible	boolean	true	Trigger motion events
motionAppear	boolean	true	Use motion when appear
motionEnter	boolean	true	Use motion when enter
motionLeave	boolean	true	Use motion when leave
motionLeaveImmediately	boolean	-	Will trigger leave even on mount
motionDeadline	number	-	Trigger motion status change even when motion event not fire
removeOnLeave	boolean	true	Remove element when motion leave end
leavedClassName	string	-	Set leaved element className
onAppearStart	(HTMLElement, Event) => CSSProperties | void;	-	Trigger when appear start, return style will patch to element
onEnterStart	(HTMLElement, Event) => CSSProperties | void;	-	Trigger when enter start, return style will patch to element
onLeaveStart	(HTMLElement, Event) => CSSProperties | void;	-	Trigger when leave start, return style will patch to element
onAppearActive	(HTMLElement, Event) => CSSProperties | void;	-	Trigger when appear active, return style will patch to element
onEnterActive	(HTMLElement, Event) => CSSProperties | void;	-	Trigger when enter active, return style will patch to element
onLeaveActive	(HTMLElement, Event) => CSSProperties | void;	-	Trigger when leave active, return style will patch to element
onAppearEnd	(HTMLElement, Event) => boolean | void;	-	Trigger when appear end, will not finish when return false
onEnterEnd	(HTMLElement, Event) => boolean | void;	-	Trigger when enter end, will not finish when return false
onLeaveEnd	(HTMLElement, Event) => boolean | void;	-	Trigger when leave end, will not finish when return false

CSSMotionList

extends all the props from CSSMotion

Property	Type	Default	Description
keys	React.Key[]	-	Motion list keys
component	string | React.ComponentType	div	wrapper component

Development

npm install
npm start

License

@rc-component/motion is released under the MIT license.

Similar packages

Other packages similar to @rc-component/motion

react-spring

react-spring is a popular library for creating animations in React. It provides a more physics-based approach to animations, allowing for more natural and fluid motion. Compared to @rc-component/motion, react-spring offers a wider range of animation types and more control over the animation lifecycle.

framer-motion

framer-motion is a powerful animation library for React that offers a simple API for creating complex animations. It provides features like layout animations, shared layout transitions, and gesture animations. Framer Motion is more feature-rich compared to @rc-component/motion and is suitable for more advanced animation needs.