use-css-transition

Installation

1npm install use-css-transition

Usage

useCssTransition is sort of like a CSS transition group, but with the API Of react-spring's useTransition() hook.

Here's a quick example:

1import React, { useState } from 'react';
2import { useCSSTransition } from 'use-css-transition';
3
4function AnimatedList() {
5  const [list, setList] = useState(['foo', 'bar', 'baz']);
6
7  const transitions = useCSSTransition(list, (item) => item, {
8    common: {
9      willChange: 'opacity',
10      transition: 'opacity 1s',
11    },
12    from: { opacity: 0 },
13    enter: { opacity: 1 },
14    leave: { opacity: 0 },
15    enterTime: 1000,
16    leaveTime: 1000,
17  });
18
19  return (
20    <div>
21      {transitions.map(({ item, style, key }) => {
22        <div key={key} style={style}>
23          {item}
24        </div>;
25      })}
26    </div>
27  );
28}

Examples

Masonry Layout: (edit on codesandbox)

API

useCSSTransition(array, getKey, config)

array is an array of items to render, getKey is a function that takes an item and returns a string, and config is a { common?, initial?, from, enter, update?, leave, enterTime, leaveTime } object. config has the following properties:

• enterTime, leaveTime are the expected time it takes an object to transition from "enter" to "update" and from "leave" to being gone.
• common is an optional set of CSS styles to apply to all items.
• initial, if provided, is a set of CSS styles to apply to items that are in the initial set of items when useCssTransition() is called for the first time. If this is not provided, from will be used instead.
• from is the set of CSS styles to apply to a new object when it is added to the set of items - this will only be applied for one "tick", as the very next render enter will be used instead.
• enter is the set of CSS styles to apply to an object while it is entering.
• update is the set of CSS styles to apply to an object after enterTime has elapsed. If not provided, enter will be used instead.
• leave is the set of CSS styles to apply to an object after it has been removed from items - in this case the item will be kept in the return results for leaveTime milliseconds, with leave styles applied, before finally being removed. If the item (or another item with the same key) is added back in before this time, the item will transition bask to update.

The return value will be an array of the following fields:

• item is an item from the array.
• index is the index of the item in the array. Note that if you move items around in your array, they will not move around in the returned array, but their index will change. We want to render items in a stable order if we want CSS transitions to work.
• style is the style to apply to the item.
• key is a unique key for this item.
• state is one of 'from' | 'enter' | 'update' | 'leave' and represents the current state of this item.
• nextUpdate is 0 if the item needs to update immediately, or a time in ms since the epoch when this item will next update.

useTransition(array, getKey, config)

This is like useCSSTransition(), except you can pass in any props you want instead of just CSS properties. This is most useful when you want to construct two different styles for related objects (like you want to scale and position and image, and want to position but not scale text over top of the image).

This does not do any kind of interpolation - you have to take care of that part yourself (or let your browser's CSS engine take care of it, ideally).

Copyright 2021 Jason Walton