⏰ A lightweight and performant flip style timer, built with https://github.com/PButcher/fliptimer.
- 💡 Lightweight - No jQuery! <11KB minified bundle
- ⚡ Performant - Animations powered by CSS transitions
- 📱 Responsive - Works great on screens of all sizes
- 🎨 Themeable - Choose from built-in themes, or add your own
- 🌍 i18n - Customisable headings for your language
new FlipTimer(1538137672).start();Include the CSS and JS in <head> and include the following line in your HTML.
<div id="fliptimer" class="fliptimer"></div>See a full example here.
To use multiple instances of FlipTimer on the same page, specify a DOM element ID as the second argument in FlipTimer's constructor:
new FlipTimer(1588017373, "registerBy").start();
new FlipTimer(1593561600, "eventStart").start();<div id="registerBy" class="FlipTimer"></div>
<div id="eventStart" class="FlipTimer"></div>FlipTimer comes with 2 themes as standard:
- dark [default]
- light
To change the theme, you can supply the theme property in the opt object in the constructor with the theme name as a string:
{
theme: "light";
}For example, to instantiate FlipTimer using the light theme instead:
new FlipTimer(1538137672, {
theme: "light",
}).start();Custom themes can be added by adding a new stylesheet using the FlipTimer theme template.
FlipTimer themes must have the class name prefix of: .FlipTimer__theme- followed by the name of your theme. For example, the standard theme class names are:
.FlipTimer__theme-dark.FlipTimer__theme-light
You can then load your theme by specifying the theme property in the opt object of the constructor (see Themes).
You can add your own rotor group headings by passing an array as part of the opt object. Bear in mind this won't change the functionality of the rotors (eg: the 'days' rotor won't magically start counting months because you passed it 'Months' as a heading).
Suggested use is for i18n. Usage as follows:
new FlipTimer(1538137672, {
headings: ["Nap", "Óra", "Perc", "Másodperc"],
}).start();Note that headings will default to English if not provided: ["Days", "Hours", "Minutes", "Seconds"]
Create a new FlipTimer instance.
Type: number
The unix timestamp to count down to (in seconds).
Optional
Type: string (default: FlipTimer)
The DOM element ID to attach this FlipTimer instance to. Defaults to FlipTimer.
Optional
Type: object (default: {})
Optionally specify additional configuration settings. Currently supported settings include:
Start the timer.
Call a function once the timer has ended.
Type: function
Function to execute once the timer has ended.
var FlipTimer = new FlipTimer(1538137672)
// Start the timer
.start()Thanks to the following people for their suggestions/fixes:
- @chuckbergeron for his help with making FlipTimer responsive.
- @vasiliki-b for spotting and fixing the Safari backface-visibility issue.
- @joeinnes for adding i18n to rotor group headings.