Skip to content

A tiny package for an animated text typing effect. Zero external dependencies. Works with React or any Javascript library.

Notifications You must be signed in to change notification settings

jonnycolby/typerloop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Typerloop

One infinite typing loop.

Typerloop is a tiny package for producing an animated text typing effect. Zero external dependencies. Works with React or any Javascript library.

NPM

NPM Repository | CodePen Example

CDN

You can use the CDN version of this plugin for fast and easy setup.

<script src="https://unpkg.com/typerloop@latest/index.js"></script>

Installation

You can install Typerloop with just one command and you're good to go

# with npm
npm i typerloop

# with yarn
yarn add typerloop

Options

Name Type Default value Description
text String or Array ["Hello!"] An array of strings to cycle through.

Methods

Name Params Description
start - Start the typing effect.
unmount - Unmount with component to avoid memory leaks.

Examples

Live Demo

Basic example

var typer = new Typerloop({
    text: ["Hello", "This is how the Typerloop works."],  // a set of text items to be typed sequentially;
    min:   24,         // minimum number of milliseconds before the next character is typed;
    max:   160,        // maximum number of milliseconds before the next character is typed;
    word_min:   0,     // minimum number of milliseconds before the next word is typed, in addition to character delay;
    word_max:   240,   // maximum number of milliseconds before the next word is typed, in addition to character delay;
    delay: 1000,       // milliseconds to show the completed text item before switching to the next;
    on_update: (new_text, new_character, previous_character)  => {
        // text updated to string new_text;
        // the most recently added character is new_character,
        //   and the one before is previous_character;
        my_do_something_method(new_text);
    },
    on_next: (full_text) => {
        // the current text item switched and Typerloop will now type full_text;
        my_text_did_switch_method(full_text);
    },
    on_loop: () => {
        // finished typing all strings, looping back to the first string;
        my_text_items_did_loop_to_beginning();
    }
});

typer.start();

React example

See the example component in the /examples directory.

About

A tiny package for an animated text typing effect. Zero external dependencies. Works with React or any Javascript library.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published