# @charlesvien/react-animatecss

> A React component implementing the latest version of Animate.css

Latest version **1.0.10** (published 2021-09-27) · MIT license · 0 weekly downloads

## Install

```sh
npm install @charlesvien/react-animatecss
pnpm add @charlesvien/react-animatecss
yarn add @charlesvien/react-animatecss
bun add @charlesvien/react-animatecss
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.10 |
| Published | 2021-09-27 |
| First published | 2021-07-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=8 |
| Dependencies | 1 |
| Unpacked size | 80.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 14 |
| Author | Charles Vien |
| Maintainers | charlesvien |
| Keywords | react, animated, animatecss, animate-css, animation, animated.css |

## Links

- npm: https://www.npmjs.com/package/@charlesvien/react-animatecss
- Repository: https://github.com/charlesvien/react-animatecss
- npm.io page: https://npm.io/package/@charlesvien/react-animatecss

## Dependencies (1)

- [prop-types](https://npm.io/package/prop-types.md) ^15.7.2

## Alternatives

- [@luma.gl/experimental](https://npm.io/package/@luma.gl/experimental.md) — 77.1K weekly downloads
- [persona-harness](https://npm.io/package/persona-harness.md) — 4.7K weekly downloads
- [@tsparticles/effect-bubble](https://npm.io/package/@tsparticles/effect-bubble.md) — 4.6K weekly downloads
- [f3d](https://npm.io/package/f3d.md) — 730 weekly downloads
- [spark-html-motion](https://npm.io/package/spark-html-motion.md) — 298 weekly downloads

## Recent versions

- 1.0.10 (latest) — 2021-09-27
- 1.0.9 — 2021-09-15
- 1.0.8 — 2021-09-15
- 1.0.6 — 2021-08-06
- 1.0.5 — 2021-08-06
- 1.0.3 — 2021-08-06
- 1.0.2 — 2021-08-06
- 1.0.1 — 2021-08-04
- 1.0.0 — 2021-08-04
- 0.1.0 — 2021-08-04
- 0.0.12 — 2021-08-04
- 0.0.11 — 2021-08-04
- 0.0.10 — 2021-08-04
- 0.0.9 — 2021-08-04
- 0.0.8 — 2021-08-04
- … 3 more at https://npm.io/package/@charlesvien/react-animatecss/versions

## README

# react-animatecss

[![npm package][npm-img]][npm-url]
[![Downloads][downloads-img]][downloads-url]
[![Build Status][build-img]][build-url]

> A React component implementing the latest version of [Animate.css](https://animate.style)!

- **Zero dependencies** - All self contained code
- **Minimal package size** - <7 kB gzipped
- **No messy installation** - A simple way to add motion to your react components

## Demo

[Take a look at the demo](https://react-animatecss.com/)

## Installation

```bash
# with npm
npm install @charlesvien/react-animatecss

# with yarn
yarn add @charlesvien/react-animatecss
```

## Documentation

The official Animate.css documentation can be found at https://animate.style. You can view a list of all animations that your able to use with this component on their website.

## Usage

This is a basic example showing how to add a fadeIn and fadeOut animation to a component.

**NOTE:** In order for the fadeOut animation to occur, instead of conditionally rendering the component you must pass ``false`` to the ``visible`` prop when the component should no longer be visible.

```js
import Animate from '@charlesvien/react-animatecss';

<Animate
  animationIn="fadeIn"
  animationOut="fadeOut"
  inDuration={1000}
  outDuration={1000}
  visible
>
  Magnolia
</Animate>
```

## API

| Prop         | Type     | Default     | Description                                                          |
|--------------|----------|-------------|----------------------------------------------------------------------|
| animationIn  | string   | fadeIn      | The animation name to be played when the component turns visible     |
| animationOut | string   | fadeOut     | The animation name to be played when the component turns invisible   |
| inDelay      | number   | 0           | The delay before the visible animation is played                     |
| outDelay     | number   | 0           | The delay before the invisible animation is played                   |
| inDuration   | number   | 1000        | The duration the visible animation is played                         |
| outDuration  | number   | 1000        | The duration the invisible animation is played                       |
| repeat       | number   | 0           | How many times the animation repeats (min: 1, max: 3)                |
| onMount      | boolean  | true        | If the animation should play when the component is first mounted     |
| visible      | boolean  | true        | If the Animate component should be visible                           |
| loop         | boolean  | false       | If the animation should infinitely loop                              |
| className    | string   | _undefined_ | Additional optional css class names to apply to the container        |
| style        | object   | _undefined_ | Additional optional css properties to apply to the container         |

## Development

Contributions are welcome to react-animatecss!

To set up the project:

1.  Fork and clone the repository
2.  `$ yarn`
3.  `$ yarn dev`

Storybook will then be served on http://localhost:6006/ in watch mode, meaning you don't have refresh the page to see your changes.

[npm-img]:https://img.shields.io/npm/v/@charlesvien/react-animatecss
[npm-url]:https://www.npmjs.com/package/@charlesvien/react-animatecss
[build-img]:https://github.com/charlesvien/react-animatecss/actions/workflows/release.yml/badge.svg
[build-url]:https://github.com/charlesvien/react-animatecss/actions/workflows/release.yml
[downloads-img]:https://img.shields.io/npm/dt/@charlesvien/react-animatecss
[downloads-url]:https://www.npmtrends.com/@charlesvien/react-animatecss

---
_Source: https://npm.io/package/@charlesvien/react-animatecss · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
