npm.io
1.0.0 • Published 5 years ago

use-typical

Licence
MIT
Version
1.0.0
Deps
4
Size
19 kB
Vulns
0
Weekly
0
Stars
1

Getting Started

Animated typing in ~2.6 kb with React Hook.

npm npm dumi License jsdelivr

Live Demo https://use-typical.vercel.app

Install

yarn add use-typical

Or you can:

npm install use-typical

Usage

You can create typing animate effects by the react hook useTypical

import React from 'react';
import useTypical from 'use-typical';

export default () => {
  const ref = useTypical({
    steps: ['Hello', 1000, 'Hello world!', 500],
    loop: Infinity,
    speed: 60,
  });

  return <p ref={ref}></p>;
};

To display the blink effects, you can add the classname typingWrapper on the dom.

-<p ref={ref}></p>
+<p ref={ref} className="typingWrapper"></p>

Such as a blink cursor style like this.

.typingWrapper::after {
  content: '|';
  animation: blink 1s infinite step-start;
}

@keyframes blink {
  50% {
    opacity: 0;
  }
}

API

Hook
const ref = useTypical(options: Options);
Result
Params Description Type
ref The ref of typical text wraper React.RefObject<HTMLDocument>
Options
Params Description Type Default
steps Step array assign to the typing Array<string, number, Function> -
loop The number of loop typing animation effect, Infinity number 1
speed The speed of typing animation effect number 60

Contribute

Install dependencies,

$ npm i

Start the dev server,

$ npm start

Build documentation,

$ npm run docs:build

Build library via father-build,

$ npm run build

License

MIT