A clock-style timepicker for Bootstrap (or jQuery).

Clone this repo:
  1. e6ac014 Fixed the download link by Wang Shenwei · 8 years ago gh-pages
  2. 275676b Fixed the download link by Wang Shenwei · 8 years ago
  3. 28a6c4d Update devDependencies by Wang Shenwei · 8 years ago
  4. b2039fc Update devDependencies by Wang Shenwei · 8 years ago
  5. 3d36b56 DevDependency status badge by Wang Shenwei · 8 years ago

ClockPicker Bower version Build Status devDependency Status

A clock-style timepicker for Bootstrap (or jQuery). Documentation and examples.

Screenshot clockpicker-12-hour-screenshot

Browser support

All major browsers are supported, including IE 9+. It should look and behave well enough in IE 8.

Device support

Both desktop and mobile device are supported. It also works great in touch screen device.

Dependencies

ClockPicker was designed for Bootstrap in the beginning. So Bootstrap (and jQuery) is the only dependency(s).

Since it only used .popover and some of .btn styles of Bootstrap, I picked these styles to build a jQuery plugin. Feel free to use jquery-* files instead of bootstrap-* , for non-bootstrap project.

Usage

<!-- Bootstrap stylesheet -->
<link rel="stylesheet" type="text/css" href="assets/css/bootstrap.min.css">

<!-- ClockPicker Stylesheet -->
<link rel="stylesheet" type="text/css" href="dist/bootstrap-clockpicker.min.css">

<!-- Input group, just add class 'clockpicker', and optional data-* -->
<div class="input-group clockpicker" data-placement="right" data-align="top" data-autoclose="true">
	<input type="text" class="form-control" value="09:32">
	<span class="input-group-addon">
		<span class="glyphicon glyphicon-time"></span>
	</span>
</div>

<!-- Or just a input -->
<input id="demo-input" />

<!-- jQuery and Bootstrap scripts -->
<script type="text/javascript" src="assets/js/jquery.min.js"></script>
<script type="text/javascript" src="assets/js/bootstrap.min.js"></script>

<!-- ClockPicker script -->
<script type="text/javascript" src="dist/bootstrap-clockpicker.min.js"></script>

<script type="text/javascript">
$('.clockpicker').clockpicker()
	.find('input').change(function(){
		// TODO: time changed
		console.log(this.value);
	});
$('#demo-input').clockpicker({
	autoclose: true
});

if (something) {
	// Manual operations (after clockpicker is initialized).
	$('#demo-input').clockpicker('show') // Or hide, remove ...
			.clockpicker('toggleView', 'minutes');
}
</script>

Options

NameDefaultDescription
default''default time, 'now' or '13:14' e.g.
placement'bottom'popover placement
align'left'popover arrow align
donetext'完成'done button text
autoclosefalseauto close when minute is selected
twelvehourfalseenables twelve hour mode with AM & PM buttons
vibratetruevibrate the device when dragging clock hand
fromnow0set default time to * milliseconds from now (using with default = 'now')
initcallback function triggered after the colorpicker has been initiated
beforeShowcallback function triggered before popup is shown
afterShowcallback function triggered after popup is shown
beforeHidecallback function triggered before popup is hidden Note:will be triggered between a beforeDone and afterDone
afterHidecallback function triggered after popup is hidden Note:will be triggered between a beforeDone and afterDone
beforeHourSelectcallback function triggered before user makes an hour selection
afterHourSelectcallback function triggered after user makes an hour selection
beforeDonecallback function triggered before time is written to input
afterDonecallback function triggered after time is written to input

Operations

operationArgumentsDescription
showshow the clockpicker
hidehide the clockpicker
removeremove the clockpicker (and event listeners)
toggleView'hours' or 'minutes'toggle to hours or minutes view

What's included

clockpicker/
├── dist/
   ├── bootstrap-clockpicker.css      # full code for bootstrap
   ├── bootstrap-clockpicker.js
   ├── bootstrap-clockpicker.min.css  # compiled and minified files for bootstrap
   ├── bootstrap-clockpicker.min.js
   ├── jquery-clockpicker.css         # full code for jquery
   ├── jquery-clockpicker.js
   ├── jquery-clockpicker.min.css     # compiled and minified files for jquery
   └── jquery-clockpicker.min.js
└── src/                               # source code
    ├── clockpicker.css
    ├── clockpicker.js
    └── standalone.css                 # some styles picked from bootstrap

Development

git clone https://github.com/weareoutman/clockpicker.git
cd clockpicker
npm install -g gulp
npm install
gulp
# gulp test

Todo

  • [ ] Auto placement and align.
  • [ ] Events.
  • [ ] Customize format.
  • [ ] Seconds View ?

Change log

0.0.7

  • Enables twelve hour mode with AM & PM buttons.

0.0.6

  • Default time can be setted to now.
  • Registered as a bower package.

0.0.5

  • Functional operations.

License

MIT