andersbc/jquery.countdown360

This is a simple attractive circular countdown timer that counts down a number of seconds. The style is configurable and a callback is supported on completion.

jQuery countdown360

A simple countdown timer in seconds

This plugin provides a simple circular countdown timer with customizable settings.

Check out a Demo

Basic Usage

1. Include jQuery:

   <script src="http://ajax.googleapis.com/ajax/libs/jquery/2.0.0/jquery.min.js"></script>

2. Include plugin's code:

   <script src="dist/jquery.countdown360.min.js"></script>

3. Include the plugin container in your HTML:

<div id="countdown"></div>

3. Call the plugin:

$("#countdown").countdown360({
  radius      : 60.5,
  seconds     : 5,
  strokeWidth : 15,
  fillStyle   : '#0276FD',
  strokeStyle : '#003F87',
  fontSize    : 50,
  fontColor   : '#FFFFFF',
  autostart: false,
  onComplete  : function () { console.log('completed') }
}).start()

Default Options

{
	radius: 15.5,                    // radius of arc
	strokeStyle: "#477050",          // the color of the stroke
	strokeWidth: undefined,          // the stroke width, dynamically calulated if omitted in options
	fillStyle: "#8ac575",            // the fill color
	fontColor: "#477050",            // the font color
	fontFamily: "sans-serif",        // the font family
	fontSize: undefined,             // the font size, dynamically calulated if omitted in options
	fontWeight: 700,                 // the font weight
	autostart: true,                 // start the countdown automatically
	seconds: 10,                     // the number of seconds to count down
	remainingSeconds: undefined,     // optional number of seconds to skip ahead on start, if omitted timer will start at the value of 'seconds'	
	timeformat: 'SS',                // the time format, use "MMSS" for MM:SS format (e.g.: 07:21) 
	label: ["second", "seconds"],    // the label to use or false if none, first is singular form, second is plural
	startOverAfterAdding: true,      // Start the timer over after time is added with addSeconds
	smooth: false,                   // update the ticks every 16ms when true
	clockwise: false,                // clockwise removal of stroke 
	onComplete: function () {}
}

Functions

.start()             // starts the countdown timer
.stop()              // stops the countdown timer, onComplete is not called
.extendTimer(secs)   // extends the current timer by backing up by the number of seconds provided
.addSeconds(secs)    // adds additional seconds to the original timer and restarts if startOverAfterAdding is true

Callbacks

onComplete					// The function defined in this option is called after the timer completes.

Contributing

See Contributing

License

MIT License © John Schult