friendica-addons/dav/timepicker/README.md

1.6 KiB

timePicker

A time picker control for textfields built using jQuery. Inspired by Google Calendar.

Examples

Default:

$("#time1").timePicker();

02.00 AM - 03.30 PM, 15 minutes steps:

$("#time2").timePicker({
  startTime: "02.00", // Using string. Can take string or Date object.
  endTime: new Date(0, 0, 0, 15, 30, 0), // Using Date object here.
  show24Hours: false,
  separator: '.',
  step: 15});

An example how the two helper functions can be used to achieve advanced functionality.

  • Linking: When changing the first input the second input is updated and the duration is kept.
  • Validation: If the second input has a time earlier than the firs input, an error class is added.

The example:

// Use default settings
$("#time3, #time4").timePicker();

// Store time used by duration.
var oldTime = $.timePicker("#time3").getTime();

// Keep the duration between the two inputs.
$("#time3").change(function() {
  if ($("#time4").val()) { // Only update when second input has a value.
    // Calculate duration.
    var duration = ($.timePicker("#time4").getTime() - oldTime);
    var time = $.timePicker("#time3").getTime();
    // Calculate and update the time in the second input.
    $.timePicker("#time4").setTime(new Date(new Date(time.getTime() + duration)));
    oldTime = time;
  }
});
// Validate.
$("#time4").change(function() {
  if($.timePicker("#time3").getTime() > $.timePicker(this).getTime()) {
    $(this).addClass("error");
  }
  else {
    $(this).removeClass("error");
  }
});