0.3.0 • Published 9 years ago

substituteteacher.js v0.3.0

Weekly downloads
2
License
MIT
Repository
github
Last release
9 years ago

substituteteacher.js (demo)

Build status

Substitute Teacher

substituteteacher.js will rotate through a series of sentences, transitioning between each one.

Quick Start

substituteteacher.js is easy to use. Add the script to your page, provide a target container and call run().

Step 0: Download

Download the latest release or clone the repo:

$ git clone git@github.com:danrschlosser/substituteteacher.js

Step 1: Add the substituteteacher.min.js file

<script src="substituteteacher.min.js"></script>

Step 2: Create your container element

<div id="sub">Fallback Text</div>

Step 3: Init substituteteacher.js

var sub = new Sub([
    "A daring JavaScript library for subsitute teachers",
    "A hilarious JavaScript library for awesome taglines",
    "A svelte JavaScript library for sweet taglines",
    "A badass JavaScript library for sliding fun",
    "A JavaScript library for word substitution"
]).run();

API

Sub(sentences, options)

The Sub constructor create a new instance of sub. The sentences parameter should be a list of sentence strings. Customize the instance by passing the options parameter. The example below uses all options and their defaults:

var opts = {
  containerId: "sub",
  namespace: "sub",
  interval: 5000,
  speed: 200,
  verbose: false,
  random: false,
  best: true
};
var sub = new Sub([
    "A daring JavaScript library for subsitute teachers",
    "A hilarious JavaScript library for awesome taglines",
    "A svelte JavaScript library for sweet taglines",
    "A badass JavaScript library for sliding fun",
    "A JavaScript library for word substitution"
], opts).run();

Options

OptionDescriptionDefualt
containerIdId of the injection point for HTML"sub"
namespaceNamespace to prepend to classes used internally"sub"
intervalNumber of milliseconds between each change5000
speedNumber of milliseconds that each step of the animation should take200
verboseTrue to enable console loggingfalse
randomTrue if the first sentence to appear should be randomfalse
bestTrue if the sentences should be ordered to minimize the number of changes performedtrue

run()

Starts the rotation between sentences.