diff --git a/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/razor b/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/razor new file mode 100644 index 0000000000..1e5ec4ae52 --- /dev/null +++ b/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/razor @@ -0,0 +1,22 @@ +
+
+ + @Html.EJS().Switch("switch").Change("toggleStickyHeader").Render() +
+
+ @(Html.EJS().TreeGrid("TreeGrid").DataSource((IEnumerable)ViewBag.datasource).Height("100%").Columns(col => + { + col.Field("TaskId").HeaderText("Task ID").Width(90).TextAlign(Syncfusion.EJ2.Grids.TextAlign.Right).Add(); + col.Field("TaskName").HeaderText("Task Name").Width(180).Add(); + col.Field("StartDate").HeaderText("Start Date").Format("yMd").Type("date").TextAlign(Syncfusion.EJ2.Grids.TextAlign.Right).Width(120).Add(); + col.Field("Duration").HeaderText("Duration").Width(110).TextAlign(Syncfusion.EJ2.Grids.TextAlign.Right).Add(); + }).ChildMapping("Children").TreeColumnIndex(1).EnableStickyHeader(true).Render()) + + + + diff --git a/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/sticky-header.cs b/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/sticky-header.cs new file mode 100644 index 0000000000..a41f3a4b92 --- /dev/null +++ b/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/sticky-header.cs @@ -0,0 +1,6 @@ +public IActionResult Index() +{ + var tree = TreeGridItems.GetTreeData(); + ViewBag.datasource = tree; + return View(); +} \ No newline at end of file diff --git a/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/tagHelper b/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/tagHelper new file mode 100644 index 0000000000..160634554e --- /dev/null +++ b/ej2-asp-core-mvc/code-snippet/tree-grid/scrolling/scrolling-sticky-header/tagHelper @@ -0,0 +1,24 @@ + +
+
+ + +
+
+ + + + + + + + +
+
+ + diff --git a/ej2-asp-core-mvc/tree-grid/EJ2_ASP.MVC/scrolling.md b/ej2-asp-core-mvc/tree-grid/EJ2_ASP.MVC/scrolling.md index 9323933e4b..33cddd66be 100644 --- a/ej2-asp-core-mvc/tree-grid/EJ2_ASP.MVC/scrolling.md +++ b/ej2-asp-core-mvc/tree-grid/EJ2_ASP.MVC/scrolling.md @@ -1,6 +1,6 @@ --- layout: post -title: Scrolling in ##Platform_Name## Tree Grid Component +title: Scrolling in Syncfusion ##Platform_Name## Tree Grid Component description: Learn here all about Scrolling in Syncfusion ##Platform_Name## Tree Grid component of Syncfusion Essential JS 2 and more. platform: ej2-asp-core-mvc control: Scrolling @@ -11,17 +11,17 @@ documentation: ug # Scrolling -The scrollbar will be displayed in the treegrid when content exceeds the element [`Width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Width.html) or [`Height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html). The vertical and horizontal scrollbars will be displayed based on the following criteria: +The scrollbar will be displayed in the treegrid when content exceeds the element [`Width`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Width) or [`Height`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Height). The vertical and horizontal scrollbars will be displayed based on the following criteria: The vertical scrollbar appears when the total height of rows present in the treegrid exceeds its element height. The horizontal scrollbar appears when the sum of columns width exceeds the treegrid element width. -The [`Height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html) and [`Width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Width.html) are used to set the treegrid height and width, respectively. +The [`Height`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Height) and [`Width`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Width) are used to set the treegrid height and width, respectively. -N> The default value for [`Height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html) and [`Width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Width.html) is **auto**. +N> The default value for [`Height`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Height) and [`Width`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Width) is **auto**. ## Set width and height -To specify the [`Width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Width.html) and [`Height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html) of the scroller in the pixel, set the pixel value to a number. +To specify the [`Width`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Width) and [`Height`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Height) of the scroller in the pixel, set the pixel value to a number. {% if page.publishingplatform == "aspnet-core" %} @@ -46,12 +46,10 @@ To specify the [`Width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js {% endtabs %} {% endif %} - - ## Responsive with parent container -Specify the [`Width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Width.html) and [`Height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html) as **100%** to make the treegrid element fill its parent container. -Setting the [`Height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html) to **100%** requires the treegrid parent element to have explicit height. +Specify the [`Width`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Width) and [`Height`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Height) as **100%** to make the treegrid element fill its parent container. +Setting the [`Height`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_Height) to **100%** requires the treegrid parent element to have explicit height. {% if page.publishingplatform == "aspnet-core" %} @@ -76,11 +74,28 @@ Setting the [`Height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/ {% endtabs %} {% endif %} +## Sticky header + +The Syncfusion ASP.NET MVC TreeGrid provides a useful feature to keep the column headers fixed (sticky) while scrolling through large datasets. This ensures that the headers remain visible at all times, enhancing user experience by making it easier to understand the context of the data displayed, especially when dealing with wide or long hierarchical data. + +For example, in a project management application, users often need to scroll through a detailed list of tasks and subtasks. When the dataset is large, scrolling down can cause confusion if the column headers scroll out of view, making it difficult to remember what each column represents. By enabling sticky headers, the column headers remain visible even while scrolling, allowing users to easily keep track of the data context. +To enable sticky headers in the TreeGrid, you can simply set the `EnableStickyHeader` property to **true**. This makes the column headers stick to the top of the TreeGrid container or its parent scrolling container when you scroll vertically. + +The following sample demonstrates how to enable or disable the sticky header in the TreeGrid using a [Switch](https://ej2.syncfusion.com/aspnetmvc/documentation/switch/getting-started) and its [Change](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Buttons.Switch.html#Syncfusion_EJ2_Buttons_Switch_Change) event: + +{% tabs %} +{% highlight cshtml tabtitle="CSHTML" %} +{% include code-snippet/tree-grid/scrolling/scrolling-sticky-header/razor %} +{% endhighlight %} +{% highlight c# tabtitle="sticky-header.cs" %} +{% include code-snippet/tree-grid/scrolling/scrolling-sticky-header/sticky-header.cs%} +{% endhighlight %} +{% endtabs %} ## Scroll to selected row -You can scroll the treegrid content to the selected row position by using the [`RowSelected`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~RowSelected.html) event. +You can scroll the treegrid content to the selected row position by using the [`RowSelected`](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.TreeGrid.TreeGrid.html#Syncfusion_EJ2_TreeGrid_TreeGrid_RowSelected) event. {% if page.publishingplatform == "aspnet-core" %} @@ -104,5 +119,3 @@ You can scroll the treegrid content to the selected row position by using the [` {% endhighlight %} {% endtabs %} {% endif %} - - diff --git a/ej2-asp-core-mvc/tree-grid/EJ2_ASP.NETCORE/scrolling.md b/ej2-asp-core-mvc/tree-grid/EJ2_ASP.NETCORE/scrolling.md index 7402a49635..6a60668038 100644 --- a/ej2-asp-core-mvc/tree-grid/EJ2_ASP.NETCORE/scrolling.md +++ b/ej2-asp-core-mvc/tree-grid/EJ2_ASP.NETCORE/scrolling.md @@ -8,7 +8,6 @@ publishingplatform: ##Platform_Name## documentation: ug --- - # Scrolling in Tree Grid Control The scrollbar will be displayed in the treegrid when content exceeds the element [`width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Width.html) or [`height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html). The vertical and horizontal scrollbars will be displayed based on the following criteria: @@ -46,8 +45,6 @@ To specify the [`width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js {% endtabs %} {% endif %} - - ## Responsive with parent container Specify the [`width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Width.html) and [`height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html) as **100%** to make the treegrid element fill its parent container. Setting the [`height`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/Syncfusion.EJ2~Syncfusion.EJ2.TreeGrid.TreeGrid~Height.html) to **100%** requires the treegrid parent element to have explicit height. @@ -75,7 +72,24 @@ Specify the [`width`](https://help.syncfusion.com/cr/cref_files/aspnetcore-js2/S {% endtabs %} {% endif %} +## Sticky header + +The Syncfusion ASP.NET MVC TreeGrid provides a useful feature to keep the column headers fixed (sticky) while scrolling through large datasets. This ensures that the headers remain visible at all times, enhancing user experience by making it easier to understand the context of the data displayed, especially when dealing with wide or long hierarchical data. + +For example, in a project management application, users often need to scroll through a detailed list of tasks and subtasks. When the dataset is large, scrolling down can cause confusion if the column headers scroll out of view, making it difficult to remember what each column represents. By enabling sticky headers, the column headers remain visible even while scrolling, allowing users to easily keep track of the data context. + +To enable sticky headers in the TreeGrid, you can simply set the `EnableStickyHeader` property to **true**. This makes the column headers stick to the top of the TreeGrid container or its parent scrolling container when you scroll vertically. +The following sample demonstrates how to enable or disable the sticky header in the TreeGrid using a [Switch](https://ej2.syncfusion.com/aspnetmvc/documentation/switch/getting-started) and its [Change](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Buttons.Switch.html#Syncfusion_EJ2_Buttons_Switch_Change) event: + +{% tabs %} +{% highlight cshtml tabtitle="CSHTML" %} +{% include code-snippet/tree-grid/scrolling/scrolling-sticky-header/tagHelper %} +{% endhighlight %} +{% highlight c# tabtitle="sticky-header.cs" %} +{% include code-snippet/tree-grid/scrolling/scrolling-sticky-header/sticky-header.cs%} +{% endhighlight %} +{% endtabs %} ## Scroll to selected row