From 5a15e0f13ba8c9b0edab3d02e5141944f525d368 Mon Sep 17 00:00:00 2001 From: Hristian Stefanov Date: Mon, 6 Jun 2022 02:21:11 +0300 Subject: [PATCH 1/4] docs(calendar):Add TopView parameter --- components/calendar/navigation.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/components/calendar/navigation.md b/components/calendar/navigation.md index 2bb0fe4402..bba41bf720 100644 --- a/components/calendar/navigation.md +++ b/components/calendar/navigation.md @@ -50,15 +50,17 @@ The user can click on an item in the current view to go to the more detailed vie You can control the initial view by setting the `View` property to a member of the `Telerik.Blazor.CalendarView` enum as listed above. -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. +You can control how much detail the user can go into by setting the `BottomView` and the `TopView` property to the same enum. Once the user reaches this top or bottom view, clicking the items selects them and does not navigate to a more detailed view. + +The `TopView` cannot be more detailed than the `BottomView`. >caption Control current view and how deep the user can go ````CSHTML -The user starts in the Decade view and can only go down to years. +The user can only go down to years on both - TopView and BottomView.
- @@ -78,13 +80,9 @@ The user starts in the Decade view and can only go down to years. } ```` ->caption The behavior of the code snippet above - -![Blazor Up Down Navigation](images/up-down-navigation.gif) - ## Programmatic Navigation -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. +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. >caption Navigate the Calendar to a date and view programmatically From 2f738e660f757a673820c99a557548d8354237c3 Mon Sep 17 00:00:00 2001 From: Hristian Stefanov Date: Mon, 20 Jun 2022 00:37:38 +0300 Subject: [PATCH 2/4] chore(calendar): fixes as per comment --- components/calendar/navigation.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/components/calendar/navigation.md b/components/calendar/navigation.md index bba41bf720..8ac96922ed 100644 --- a/components/calendar/navigation.md +++ b/components/calendar/navigation.md @@ -48,11 +48,9 @@ The calendar offers several views that show the user different periods of time: 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). -You can control the initial view by setting the `View` property to a member of the `Telerik.Blazor.CalendarView` enum as listed above. +To control the initial view, set the `View` property to a member of the `Telerik.Blazor.CalendarView` enum as listed above. -You can control how much detail the user can go into by setting the `BottomView` and the `TopView` property to the same enum. Once the user reaches this top or bottom view, clicking the items selects them and does not navigate to a more detailed view. - -The `TopView` cannot be more detailed than the `BottomView`. +To control how much detail the user can go into, set the [`BottomView` and the `TopView`](#topview-and-bottomview) property to the same enum. >caption Control current view and how deep the user can go @@ -80,6 +78,12 @@ The user can only go down to years on both - TopView and BottomView. } ```` +## TopView and BottomView + +`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`. + +`TopView` sets the least level of detail (i.e. greatest level of date aggregation). Its default value is `CalendarView.Century`. + ## Programmatic Navigation 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. From eb5fd817ec0925515a80cb66bcc1ae6907d7022a Mon Sep 17 00:00:00 2001 From: Hristian Stefanov <72554148+xristianstefanov@users.noreply.github.com> Date: Mon, 20 Jun 2022 17:13:12 +0300 Subject: [PATCH 3/4] Update components/calendar/navigation.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> --- components/calendar/navigation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/calendar/navigation.md b/components/calendar/navigation.md index 8ac96922ed..be35877ed6 100644 --- a/components/calendar/navigation.md +++ b/components/calendar/navigation.md @@ -50,7 +50,7 @@ The user can click on an item in the current view to go to the more detailed vie To control the initial view, set the `View` property to a member of the `Telerik.Blazor.CalendarView` enum as listed above. -To control how much detail the user can go into, set the [`BottomView` and the `TopView`](#topview-and-bottomview) property to the same enum. +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. >caption Control current view and how deep the user can go From da89fcf989d99a0c5f59d7222e0e77139ffdfab3 Mon Sep 17 00:00:00 2001 From: Hristian Stefanov <72554148+xristianstefanov@users.noreply.github.com> Date: Mon, 20 Jun 2022 17:13:23 +0300 Subject: [PATCH 4/4] Update components/calendar/navigation.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> --- components/calendar/navigation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/calendar/navigation.md b/components/calendar/navigation.md index be35877ed6..4414d21cd4 100644 --- a/components/calendar/navigation.md +++ b/components/calendar/navigation.md @@ -48,7 +48,7 @@ The calendar offers several views that show the user different periods of time: 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). -To control the initial view, set the `View` property to a member of the `Telerik.Blazor.CalendarView` enum as listed above. +To control the initial view, set the `View` property to a member of the `Telerik.Blazor.CalendarView` enum, as listed above. 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.