Skip to content

A tiny library that simulates the typewriter animation for JavaScript and TypeScript

License

Notifications You must be signed in to change notification settings

amelekhin/microwriter

Repository files navigation

Microwriter npm bundlephobia

A tiny library that simulates the typewriter animation for JavaScript and TypeScript

Installation

  • Use pre-compiled modules in the dist/ directory.
  • Use pika.dev to import the module without bundling:
import microwriter from 'https://cdn.pika.dev/microwriter@^x.y.z';

const writer = microwriter({ ... });
  • Use npm or yarn:
$ npm install microwriter

Example

A working example can be found in the example/ directory. The usage is very straightforward:

// Find a target element to write text into
const target = document.getElementById('microwriter-target');

// Initialize a writer
const writer = microwriter({
  // The target
  target,

  // The lines list
  lines: ['Hello, world', 'This is Microwriter'],

  // Print in infinite loop
  // Default is false
  loop: true,

  // Delete whole line at a time before writing next or preserve the line if there's only one in the list
  // Default is false
  preserve: false,

  // The writing speed in milliseconds
  writeSpeed: 150,

  // The deletion speed in milliseconds
  // If not provided, writeSpeed is used instead
  deleteSpeed: 50,

  // A delay in milliseconds before writing a new line
  writeLineDelay: 400,

  // A delay in milliseconds before deleting a written line
  deleteLineDelay: 1000,
});

// Start writing
writer.start();

// Pause writing
writer.pause();

// Replace lines and restart
writer.replaceLines(['My next list', 'of lines.']);

License

MIT.