HTML5 canvas timepicker, inspired on windows 8 alarms app. Works in all modern browsers
Branch: master
Clone or download
Latest commit a194809 Sep 1, 2014

README.md

html5-timepicker

HTML5 canvas timepicker, inspired on windows 8 alarms app. Can be used as a time input field (instead of form) on a website and as a clock on a website.

Works in all modern browsers that support html5 canvas and fully touch-friendly

Uses HTML5, javascript but not Jquery. Can easily be used as plugin.

Look at the timepicker-demo.html file for examples

See it working at http://raspberry.vanoorschot.biz/code/timepicker/timepicker-demo.html

use as

[name] = new timePicker( [canvas to bind to] , [ options ] )

the [name] is used to call any of the functions after creation

options

  • hours -> initial number of hours
  • minutes -> initial minutes
  • drawHandles -> whether to draw handles and enable dragging. If false it is a sort of clock
  • centerX, centerY -> define a custom center position for the timepicker. The center of the canvas is default
  • animationStep -> number of drawings to animate the handler to its position default is 5, so 50ms
  • drawInterval -> number of milliseconds between drawing. default is 10ms = 100hz. The real speed depends on the browser and computer.
  • scale -> set the scale of the timepicker. This is the number of pixels the arcs for minutes and hours is thick. The alarms app uses 40px. When not set, it adapts to the canvas size: scale = smallest_side / 10.

functions

  • onTimeChange -> callback on dragging the handles
  • onCenterClick -> callback on clicking on the center to set options after creating the timePicker use these functions.
  • [name].setTime([hours],[minutes]) to set the time
  • [name].setColor([name of color]) to set a predefined color. [name of color] can be 'pink', 'green', 'orange' or 'blue'. To set it to a custom color, pass an array as [name of color] in the format
	{
		h: rgba(97,164,0,1), //color for hours <12
		h2: rgba(97,164,0,1), //color for hours >12
		m: rgba(97,164,0,1)   //color for minutes
	}

to retrieve values at any moment use

  • [name].getTime() to get the array [hours, minutes]
  • [name].getTimeStr() to get hours:minutes

jQuery

To use this with jQuery, use the jquery wrapper plugin 'jquery-timepicker.js' and also include the original file 'timePicker.js'. See examplejQuery.html for example

use selector.data('tp') to access the timePicker javascript functions:

  • $('#1').data('tp').setColor('green')

WinJS

The timepicker can be used in a winJS windows 8.1 or phone 8.1 app just like it can be used on a website. Include the timePicker.js in the js folder of the project.

C#

A C# version is under development