Wodry.js is a simple jQuery plugin for a text flipping/rotating written in CoffeeScript. It was inspired by the Adjector.js. Wodry.js does the same things but it has new features that allow you to set animation from animations collection, set your own callback on content flipping, etc
Branch: master
Clone or download
daynin Merge pull request #10 from gate8team/master
Added abillity to return interval id to clear it if needed.
Latest commit 0d43b23 Jun 17, 2015

README.md

##About

Wodry.js is a simple jQuery plugin for a text flipping/rotating written in CoffeeScript. It was inspired by the Adjector.js. Wodry.js does the same things but it has new features that allow you to set animation from animations collection, set your own callback on content flipping, etc.

[![examples-gif](./wodry-examples.gif "Examples")](http://daynin.github.io/wodry/#examples)

##How to get it

You can download this repository or install it from Bower:

bower install wodry

##How it works

In the first place you need to include wodry.css and wodry.js (or wodry.min.js) files then create html tag with content that will flip/rotate (like this):

<div>
    Bla bla bla <span class="wodry">word1|word2|word3</span>
</div>

And in the script tag add this:

$('.wodry').wodry();

In this case it will works with default settings. But if you want you can specify settings of wodry.js:

$('.wodry').wodry({
    //settings
});

If you want to stop flipping, you need to know that right after initialization of your element wodry.js will return you interval ids for every element was process, so you will have ability to clear interval thereby stopping wordy flipping execution:

var intervalIds = $('.wodry').wodry({
    //settings
});

// to clear first element flipping just use:
if (intervalIds != null) {
    clearInterval(intervalIds[0]);
}

Settings object has the following fields:

  • separator: sets a custom separator between flipped text. Default value: "|";
  • delay: sets a delay of interations. Default value: 2000;
  • animationDuration: sets duration of animation. Default value: 500;
  • animation: sets a type of animation. Default value: 'rotateY';
  • callback: sets a callback that calls on each iteration. Default value: an empty function;
  • shift: specify the X,Y and Z values of shifting. Default value: {x:0,y:0,z:0};
  • styles: set an array of styles (for example: ['style1','style2','style3']). It will change a style of a wodry tag on each flip one by one;

List of animations:

  • rotateX;
  • rotateY;
  • rotateAll;
  • scaleX;
  • scaleY;
  • scaleAll;
  • clockwise;
  • anticlockwise;

##Examples here

##Development

###Prerequirements

    npm install -g grunt-cli

When node.js and grunt will be installed you need to run 'npm install' command in a root folder of the project for installation of all dependencies.

For autocompiling .coffeescript to .js run grunt with 'dev' parameter in a root folder of the project:

    grunt dev

For project building run:

    grunt

###Contributions & Issues

All your issues and pull requests are welcome!