Introduction

jquery.timepickr was created in a attempt to make the process of inputing time in a form as easy and natural as possible.

Goals

• Be unobtrusive
• Degrade gracefully
• Use maximum 2 clicks
• Intuitive keyboard navigation
• Be touch device friendly

Downloads

Google Code

• Download packages
• Browse source code

Subversion

svn co http://jquery-utils.googlecode.com/svn/trunk/standalone/ui-timepickr/ jquery-timepickr

Known issues

• In 24h mode, 12h does not swap to 00h as it should when hovering am/pm
• Broken in IE6 (might take a while to fix, unless someone contribute a patch)
• I am aware that there is no such thing as am and pm in 24h convention
• Some people reported that it didn't work so well in the iPhone. Unfortunately I'm not cool, I don't own a iPone and I don't plan to buy one in a near future. So unless a skilled iPhone owner fix it for us, it won't be fixed anytime soon.

Report a bug

Please use the project's bug tracker to report bugs, also check if the bug is not already reported.

To report a bug, click on New issue and fill up the form. Don't forget to specify your OS and Browser (vendor and version). Finally, add ui-timepickr in labels.

Documentation

Basic usage

$(function(){
    $('#test-1').timepickr({
        handle: '#trigger-test'
        convention: 12 });
});

Complete reference

Documentation and the complete list of options is available on the project's wiki page on Google code.

About

Author

My name is Maxime Haineault, I work as project manager at Centdessin Design where I manage a small web development department.

I'm mostly developping this plugin in my spare times, so don't expect bugs to be fixed over night. If you want to help me improve this plugin, any kind of help would be greatly appreciated (bug fixing, documentation, new features, etc).

For that matter, if you really want a bug to be fixed quickly you can speed up the process by sending me your patches, I'll be glad to merge them into trunk if the code looks decent and doesn't break the unit tests.

Contact me

Development roadmap

Release	Milestone
0.6	First official release Working 24h mode Firefox and WebKit support (Safari & Google Chrome)
0.6.1	Input reset itself on blur when no click happens (see resetOnBlur option) Applied themeroller standards described here.
0.6.2	Forgot to remove jquery.ui from the build .. it's now a bit more slick (290kb -> 24kb) Fixed a variable scope, thanks Jeffrey Kretz
0.6.3	Fixed a CSS and for loop bug, thanks to Christoph Müller-Spengler Minor code refactoring to follow jQuery UI standards
0.6.4	Updated for jQuery 1.3 Updated for jQuery UI 1.6 Updated against new jQuery Themeroller standards Refactored/optimized ui.dropslide.js
0.6.5	Merged jquery-utils downstream bug fixes Fixed IE bugs Code cleanup
0.6.6	Fixed bugs #12, #13 Fixed option resetOnBlur Created unit tests Removed jquery.arrayUtils.js dependency New packaging (jquery.timepicker.js & ui.timepickr.js) Now including source files in distribution Minor refactoring and code cleanup Added default "system" theme
0.7	Complete refactoring Integrated a plugin architecture Removed dropslide dependency Enhanced Themeroller comptatibility Support for custom labels Support for custom split range (2h mode) Now using a Time object to manipulate input/output consistantly Added theme switcher to demo page Fixed bug 31, thanks to Nick.VP
0.8	Internet Explorer 7+ support Keyboard navigation Try integration with input masked
0.9	More demo and themes Documentation overhaul Internet Explorer 6 support
1.0	First production ready release