TimeCircles is a jQuery plugin that provides a nice looking way to either count down towards or to count up from a certain time. It provides a simple yet dynamic tool that makes it very easy to provide visitors an attractive countdown or timer.
- nevşehir escort
- trabzon escort
- kastamonu escort
- gönen escort
- çorlu escort
- samsun escort
- balıkesir escort
- muğla escort
- rize escort
- erzincan escort
1. INCLUDE JS AND CSS FILES
Setting up your reference date and time is also fairly simple. The best way to do it is to simply include it in the html element you've set aside for TimeCircles. Create an attribute called data-date and provide a value in the format of yyyy-mm-dd hh:mm:ss
<div class="example" data-date="2014-01-01 00:00:00"></div>
It is also possible that you want to use TimeCircles to count down a specific amount of time, like 15 minutes. This works similarly as creating a reference time, however here the attribute data-timer is used, and the value is the time to count down from (in seconds).
<div class="example" data-timer="900"></div>
To customize TimeCircles to fit precisely what you're looking for you can use the options. In this section we will look into what options are available and what each option means.
start (default: true)
This option determines whether or not TimeCircles should start immediately. If for example you wish to create a stopwatch that starts when the users clicks a button, you'll want to set this to false.
animation (default: "smooth")
The way the circles animate can be either a constant gradual rotating, slowly moving from one second to the other. Or it can be set to jump from one unit to the next, only changing the circle when the number within it also changes. The first type is called "smooth", the second type is called "ticks".
count_past_zero (default: true)
This option is only really useful for when counting down. What it does is either give you the option to stop the timer, or start counting up after you've hit the predefined date (or your stopwatch hits zero).
circle_bg_color (default: "#60686F")
This option determines the color of the background circle.
use_background (default: true)
This options sets whether any background circle should be drawn at all. Disabling this option could be used in isolation, or you could use a background of your own to place behind TimeCircles.
fg_width (default: 0.1)
This option sets the width of the foreground circle. The width is set relative to the size of the circle as a whole. A value of 0.1 means 10%, so if your TimeCircles are 100 pixels high, the foreground circle will be 10 percent of that (10 pixels).
bg_width (default: 1.2)
This option sets the width of the backgroundground circle. The width of the background is set relative to the width of the foreground. A value of 1 means 100%, so a value of 1 would mean having a width equal to your foreground ring. Higher and you get wider, lower you get thinner.
total_duration (default: "Auto")
This option can be set to change how much time will fill the largest visible circle. Normally this is the Days circle, but this can be any of the other circles depending on visible settings. Valid values for this variable are "Auto", "Years", "Months", "Days", "Hours","Minutes" or any numeric value (ie: 30 for thirty seconds).
direction (default: "Clockwise")
This option can be set to change the direction in which the circles fill up. Valid values for this are "Clockwise", "Counter-clockwise"or "Both".
start_angle (default: 0)
This option can be set to change the starting point from which the circles will fill up. This should be an integer value between 0 and 360. 0 is from the top, 90 from the right, 180 from the bottom and 270 from the left.
The time option is actually a group of options that allows you to control the options of each time unit independently. As such, within time each unit of time has its own sub-category. These categories are: Days, Hours, Minutes, and Seconds. The options available within each category are as follows:
- show: Determines whether the time unit should be shown at all
- text: Determines the text shown below the time. Useful for use on non-English websites
- color: Determines the color of the foreground circle of the time unit
TimeCircles does not return a jQuery object after instantiating. Instead, it returns a TimeCircles object. This means that function chaining will work slightly differently than it does for other jQuery plugins. To find out more about how to chain other jQuery plugins and functions, have a look at the end() function.
TimeCircles functions themselves (with the exception of the end() function) will return the TimeCircles object. This allows you to chain several functions into each other. IE: You could chain start() straight into addEventListener(callback).
start() , stop() and restart()
These are the most basic functions provided. They allow you to temporarily stop TimeCircles or restart it. Start will unpause the timer when it's stopped, restart will restart it from it's original value. If you're using TimeCircles to count down to a certain point in the future, upon unpausing the countdown will jump ahead.
If for some reason, you need to get rid of your TimeCircles, or you want to allow users remove them at the click of a button; you can do that with destroy.
Some options or variables are only initialized once, at the time of creating TimeCircles (For example, the width and height, or which circles are being shown). If you change these settings later on, you can have everything reinitialized anew by using .rebuild()
Retrieves the number seconds left (or since) the zero point. Values until zero are positive, values after zero are negative.
addListener (callback, type = "visible")
The type parameter allows you to listen to either only the events from the visible TimeCircles, or all TimeCircles. Correct values are"visible" or "all". The default value is "visible", but through using "all" you can listen to the circles you're hiding (if you're hiding any of course).
To add a listener, use the addEventListener(callback) function. Callback is a function you pass to the event listener. The callback will then be triggered for each event. Three parameters are passed to your callback function, namely:
- unit: The time unit in string format. So, "Days"/"Hours"/"Minutes"/"Seconds".
- value: The new value of the time unit that changed. I.e.: 15.
- total: This is the total time left (or elapsed) since the zero point.
To allow you to chain TimeCircles to other jQuery functions, you can use the end() function. The end function returns the jQuery object and allows you to trigger jQuery function as desired.