CalendarComponent
Represents the Kendo UI Calendar component for Angular.
Definition
Package:@progress/kendo-angular-dateinputs
Selector:kendo-calendar
Export Name:Accessible in templates as #kendo-calendarInstance="kendo-calendar"
Syntax:
<kendo-calendar></kendo-calendar>
Inputs
Specifies which end of the defined selection range should be marked as active. Value will be ignored if the selection range is undefined. If range selection is used then the default value is 'start'.
'start'
Defines the active view that the Calendar initially renders
(see example).
You have to set activeView within the topView-bottomView range.
allowReverse
boolean
Allows reverse selection when using range selection.
If allowReverse is set to true, the component skips the validation of whether the start date is after the end date.
false
animateNavigation
boolean
Determines whether to enable animation when navigating to previous/next view.
Applies to the classic Calendar only.
This feature uses the Web Animations API. In order to run the animation in browsers that do not support it, you need the web-animations-js polyfill.
false
Defines the bottommost view to which the user can navigate (see example).
disabled
boolean
Sets or gets the disabled property of the Calendar and
determines whether the component is active
(see example).
To learn how to disable the component in reactive forms, refer to the article on Forms Support.
false
disabledDates
Date[] | Day[] | (date: Date) => boolean
Specifies the dates of the Calendar that will be disabled (see example).
focusedDate
Date
Specifies the focused date of the Calendar (see example).
If the Calendar is outside the min or max range, the component normalizes the defined focusedDate.
footer
boolean
Toggles the visibility of the footer.
false
max
Date
Specifies the maximum allowed date value (see example).
2099-12-31
min
Date
Specifies the minimum allowed date value (see example).
1900-1-1
navigation
boolean
Determines whether the navigation side-bar will be displayed
(see example).
Applies to the infinite Calendar only.
true
rangeValidation
boolean
Determines whether the built-in min or max validators are enforced when validating a form.
false
Sets the Calendar selection mode (see example).
'single'
showOtherMonthDays
boolean
Shows days that fall outside the current month and the default values per Calendar type are false for infinite and true for classic (see example).
tabindex
number
Specifies the tabindex property of the Calendar. Based on the
HTML tabindex behavior,
it determines whether the component is focusable.
0
Defines the topmost view to which the user can navigate (see example).
Specifies the Calendar type.
'infinite'
value
Date | Date[] | SelectionRange
Sets or gets the value property of the Calendar and defines the selected value of the component.
The value has to be a valid JavaScript Date instance when in single selection mode, an array of valid JavaScript Date instances when in multiple selection mode, or an object of type SelectionRange when in range selection mode.
Specifies the format of the displayed week day names.
"short"
weekNumber
boolean
Determines whether to display a week number column in the month view
(see example).
false
Events
Fires when the active view is changed (see example).
Fires when the active view date is changed
(see example).
Applies to the infinite Calendar only.
blur
EventEmitter<any>
Fires each time the Calendar gets blurred (see example).
focus
EventEmitter<any>
Fires each time the Calendar gets focused (see example).
navigate
EventEmitter<{ activeView: CalendarView; focusedDate: Date }>
Fires when navigating in the currently active view (see example).
valueChange
EventEmitter<any>
Fires when the value is changed (see example).