slimfady

Create a random like animation of text characters

Usage no npm install needed!

<script type="module">
  import slimfady from 'https://cdn.skypack.dev/slimfady';
</script>

README

Build Status Coverage Status npm version GitHub version

SlimFady

Randomly delay revealing of each character in a text (uses CSS3 animation).

  • Doesn't remove HTML tags of animated text
  • No extra dependencies

Demo (codepen.io)

SlimFady

Getting started

npm install slimfady --save

JS

import SlimFady from 'slimfady';

const options = {
    container: '#foo'
    delay: 50
};

const sf = new SlimFady(options);

CSS

// CSS
<link rel="stylesheet" href="node_modules/slimfady/dist/style.css">

// or import the stylesheet in a CSS pre-processor
@import 'node_modules/slimfady/dist/style.css';

DOM

<!DOCTYPE html>
<html>
  <head>  
  </head>
  <body>
    <div id="test" class="sf-container">hello</div>
  </body>
</html>

API

Options

{
    container: '#foo'
    delay: 50
}

options.container, string, required

CSS selector of a single DOM node.

options.delay, number, optional, default = 20

Defines time range between starting animation of each character, smaller value => faster animation.

Methods

sf.startAnimation()

sf.stopAnimation()

Stops and also pauses animation if it's still in progress. If you would like to remove animation and reveal the whole text immediately, use clearAnimation().

sf.isAnimating()

sf.clearAnimation()

Removes animation and reveals the whole text. It doesn't remove newly created <span> elements. After calling clearAnimation(), you can easily start animation from the beginning by using startAnimation().

License

MIT