Skip to content

component/calendar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Calendar

Calendar UI component designed for use as a date-picker, full-sized calendar or anything in-between.

javascript calendar component

Live demo is here

Installation

$ component install component/calendar

Example

var Calendar = require('calendar');
var cal = new Calendar;
cal.el.appendTo('body');

Events

  • view change (date, action) when the viewed month/year is changed without modification of the selected date. This can be done either by next/prev buttons or dropdown menu. The action will be "prev", "next", "month" or "year" depending on what action caused the view to change.
  • change (date) when the selected date is modified

API

new Calendar(date)

Initialize a new Calendar with the given date shown, defaulting to now.

Calendar#select(date)

Select the given date (Date object).

Calendar#show(date)

Show the given date. This does not select the given date, it simply ensures that it is visible in the current view.

Calendar#showMonthSelect()

Add month selection input.

Calendar#showYearSelect([from], [to])

Add year selection input, with optional range specified by from and to, which default to the current year -10 / +10.

Calendar#prev()

Show the previous view (month).

Calendar#next()

Show the next view (month).

Calendar#min()

Define earliest valid date - calendar won't generate change events for dates before this one.

Calendar#max()

Define latest valid date - calendar won't generate change events for dates after this one.

Calendar#locale({months, weekdaysMin})

Set alternative locale:

  • months - an array of 12 strings representing month names January..December.
  • weekdaysMin - an array of 7 strings representing day names shortcuts Sunday..Saturday

Themes

Aurora:

License

MIT