@kcuf-ui/rc-transition

A ~~fork~~ rewritten of https://www.npmjs.com/package/react-transition-group using TS and hooks.

It's NOT designed to be a drop-in replacement of react-transition-group, however some APIs are learned from it.

Why

1. react-transition-group has not been updated for over 2 years (version 4.4.5 till 2025/01/03)
2. react-transition-group is written in JS
3. react-transition-group depends on prop-types which TS react coders might hate
4. react-transition-group is in class component format
5. react-transition-group uses deprecated findDOMNode which can only be used in class component
6. react-transition-group cannot start its own dev environment now, a bunch of errors

How to Use

Using Render Props

import Transition from '@kcuf-ui/rc-transition';

const transitionStyles = {
  entering: {
    opacity: 1
  },
  entered: {
    opacity: 1
  },
  exiting: {
    opacity: 0
  },
  exited: {
    opacity: 0
  }
};

<Transition {...props}>
  {(status: 'entering' | 'entered' | 'exiting' | 'exited') => <Child style={transitionStyles[status]} />}
</Transition>

Using data-transition

import styled from 'styled-components';

import Transition from '@kcuf-ui/rc-transition';

const ScChild = styled.div`
  &[data-transition='entering'] {
    opacity: 1;
  }
  
  &[data-transition='entered'] {
    opacity: 1;
  }
  
  &[data-transition='exiting'] {
    opacity: 0;
    text-decoration: line-through;
  }
  
  &[data-transition='exited'] {
    opacity: 0;
  }
`;

<Transition {...props}>
  <ScChild />
</Transition>

Using useTransitionStatus hook

import {
  ReactElement
} from 'react';
import styled from 'styled-components';

import Transition, {
  useTransitionStatus
} from '@kcuf-ui/rc-transition';

function Child(): ReactElement {
  const transitionStatus = useTransitionStatus(); // however you would like to use it
  
  return <div>...</div>;
}

<Transition {...props}>
  <Child />
</Transition>

APIs

Exports

• Removed
  • CSSTransition → Transition + data-transition is enough
• Renamed
  • SwitchTransition → TransitionSwitch TODO
  • ReplaceTransition → TransitionReplace TODO

TransitionProps

| prop | Description | | :---: | :---: | | nodeRef | Needed when mountOnEnter \|\| unmountOnExit to force reflow. | | in | Same as react-transition-grpup. | | durationEnter?: number | Default 400ms | | durationExit?: number | Default to durationEnter | | onEnter() | No parameters. | | onEntered() | No parameters. | | onExit() | No parameters. | | onExited() | No parameters. |

These props are removed:

• ~~onEntering()~~
• ~~onExiting()~~
• ~~appear~~ → There is no appear now, treated the same as enter.
• ~~enter~~ → durationEnter: 0
• ~~exit~~ → durationExit: 0
• ~~timeout?: number \| { apear?: number; enter?: number; exit: number; }~~ → durationEnter?: number + durationExit?: number
• ~~addEventListener~~