sundial-picker v0.0.1

Sundial

A pretty nice datetime picker. Hopefully pretty accessible, definitely pretty usable. No DOM library required, just add Moment.js and you're good to go.

Minimal styling required, lots of styling possible.

Love,
Paul Straw

Usage

npm install sundial-picker or bower install sundial-picker

<input type="text" id="dingus">

var someDingus = document.getElementById('dingus');
new Sundial(someDingus, {options: goHere});

Options / Defaults

defaults =
  enableSidebar: true # Render the "current date" sidebar
  enableTimePicker: true # Allow picking time as well as date
  allowEmptyDate: true # Allow date to be cleared
  classPrefix: 'sundial' # Class prefix, for theming and stuff
  wrapperTagName: 'div' # Change the input wrapper tag
  defaultDisplayMonth: moment().startOf('month') # A `moment` specifying the default month to view when the picker is first opened. Overridden by an existing value in the passed input
  weekStart: 0 # First day of the week (0 is Sunday)
  timePickerMinuteStep: 1 # Limit which minutes that can be selected. Sixty (60) should generally be divisible by this number
  timePickerSeparator: ':' # Symbol between the hour and minute selectors
  timePickerDescription: 'Format: 24hr' # Descriptive text below time picker
  inputFormat: moment.defaultFormat # Format for input (what's actually sent to the server, defaults to ISO 8601 [YYYY-MM-DDTHH:mm:ssZ])
  maskFormat: 'dddd MMMM Do, YYYY h:mmA' # Display format for input mask
  dayOfWeekFormat: 'dd' # Display format for calendar header
  sidebarYearFormat: 'YYYY' # Display format for sidebar year
  sidebarDateFormat: 'ddd, MMM D' # Display format for sidebar date
  sidebarTimeFormat: 'h:mmA' # Display format for sidebar time
  dayButtonDateFormat: 'YYYY-MM-DD' # Internal-ish. Sets the data attribute format on calendar day buttons
  verticalPopoverOffset: 0 # Added to the popover's vertical position during placement
  horizontalPopoverOffset: 0 # Added to the popover's horizontal position during placement

Special Thanks

A lot of the calendar rendering code is adapted from the venerable Pikaday. It's well worth checking out, if Sundial isn't for you for whatever reason!

Meta Stuff

Sundial was created by Paul Straw. It's MIT-licensed (see the license file for more info). Any contribution is absolutely welcome, but please review the contribution guidelines before getting started.