Skip to content

Commit 09a596b

Browse files
docs(calendar):Add TopView property (#984)
* docs(calendar):Add TopView parameter * chore(calendar): fixes as per comment * Update components/calendar/navigation.md Co-authored-by: Dimo Dimov <[email protected]> * Update components/calendar/navigation.md Co-authored-by: Dimo Dimov <[email protected]> Co-authored-by: Dimo Dimov <[email protected]>
1 parent a739a4c commit 09a596b

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

components/calendar/navigation.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -48,17 +48,17 @@ The calendar offers several views that show the user different periods of time:
4848

4949
The user can click on an item in the current view to go to the more detailed view. They can click the current range at the top to navigate to the larger view where navigating bigger portions of time is easier (for example, years, or even decades).
5050

51-
You can control the initial view by setting the `View` property to a member of the `Telerik.Blazor.CalendarView` enum as listed above.
51+
To control the initial view, set the `View` property to a member of the `Telerik.Blazor.CalendarView` enum, as listed above.
5252

53-
You can control how much detail the user can go into by setting the `BottomView` property to the same enum. Once the user reaches this bottom view, clicking the items selects them and does not navigate to a more detailed view.
53+
To control how much detail the user can go into, set the [`BottomView` and `TopView`](#topview-and-bottomview) parameters to a member of the same enum.
5454

5555
>caption Control current view and how deep the user can go
5656
5757
````CSHTML
58-
The user starts in the Decade view and can only go down to years.
58+
The user can only go down to years on both - TopView and BottomView.
5959
<br />
6060
61-
<TelerikCalendar BottomView="@CalendarView.Year" @bind-View="@SelectedView"
61+
<TelerikCalendar TopView="@CalendarView.Year" BottomView="@CalendarView.Year" @bind-View="@SelectedView"
6262
Min="@min" Max="@max" ValueChanged="@MyValueChangeHandler">
6363
</TelerikCalendar>
6464
@@ -78,13 +78,15 @@ The user starts in the Decade view and can only go down to years.
7878
}
7979
````
8080

81-
>caption The behavior of the code snippet above
81+
## TopView and BottomView
8282

83-
![Blazor Up Down Navigation](images/up-down-navigation.gif)
83+
`BottomView` sets the greatest level of detail the user can navigate. Its default value is `CalendarView.Month`. If `View` is not set, the Calendar will initially display its `BottomView`.
84+
85+
`TopView` sets the least level of detail (i.e. greatest level of date aggregation). Its default value is `CalendarView.Century`.
8486

8587
## Programmatic Navigation
8688

87-
You can make the Calendar component move to a certain date and view through its `Date` and `View` parameters that support two-way binding. The constraints of the min/max and bottom view apply to programmatic navigation as well as to user navigation.
89+
You can make the Calendar component move to a certain date and view through its `Date` and `View` parameters that support two-way binding. The constraints of the min/max and top/bottom view apply to programmatic navigation as well as to user navigation.
8890

8991
>caption Navigate the Calendar to a date and view programmatically
9092

0 commit comments

Comments
 (0)