README
Scramble
A scramble text UI component for react.
The animation maintains an internal ticking clock, that runs up to 60 times per second, or once per animation frame. The animation starts from the beginning of the text, and scrambles until the end of the input, given a set of parameters that allow you to control how many characters are added and over how many ticks, and how many times each character is randomized.
Live demo at https://scramble.vercel.app/
Props
Property | type | default | description |
---|---|---|---|
as | string | - | polymorphic tag |
play | boolean | true | start/stop animation |
text | string | - | text to scramble. |
speed | number | 0.4 | 0-1 range that determines the ticking speed. 1 means 1 tick per frame |
scramble | number | 8 | how many times each character will randomize |
step | number | 1 | how many characters are added to the scramble on each tick |
stepInterval | number | 1 | how many ticks it requires to increment the step index |
seed | number | 3 | adds random characters to the scramble, ahead of the ticking loop |
seedInterval | number | 10 | ticks required to seed more random characters |
onComplete | function | - | callback invoked on completion |
Installation
yarn add @a7sc11u/scramble
//or
npm install @a7sc11u/scramble
Usage
import { TextScramble } from '@a7sc11u/scramble';
export const App = () => {
const elRef = React.useRef<HTMLDivElement>(null);
const handleComplete = () => {
console.log('scramble is done');
}
return (
<TextScramble
ref={elRef}
as="div"
play={true}
speed={0.4}
scramble={8}
step={1}
stepInterval={1}
seed={3}
seedInterval={10}
onComplete={handleComplete}
text="Fugiat ullamco non magna dolor excepteur."
/>
);
};