Skip to content

Commit 3017232

Browse files
svdimitrmarin-bratanov
authored andcommitted
docs(grid): Wording changes and additional information in the Notes section
1 parent 855c482 commit 3017232

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

components/grid/columns/virtual.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Virtual
2+
title: Virtualized
33
page_title: Grid for Blazor | Virtual Columns
44
description: How to add virtual columns to a scrollable Grid.
55
slug: grid-columns-frozen
@@ -10,13 +10,14 @@ position: 5
1010

1111
# Virtual Columns
1212

13-
The Grid lets you add Virtual Columns. This means that columns will be rendered only for the currently visible viewport and data will be loaded just for them.
13+
The Grid lets you add Virtualized Columns. This means that columns and the corresponding data will be rendered only for the currently visible viewport. When changing the [Page]({%slug components/grid/features/paging%}) or [Sorting]({%slug components/grid/features/sorting%}) the Grid less elements are rendered which improves the responsiveness and the overall user experience.
1414

1515
## Requirements
16-
To enable Virtual Columns:
16+
To enable Virtualized Columns:
1717
* Set the `ColumnVirtualization` parameter of the Grid to `true`.
1818
* Set the `Width` parameter of all columns in `px` so that the total sum is greater than the `Width` of the Grid which will enable horizontal scrollbar. You can read more about the scrolling behavior of the grid in the [Grid Column Width Behavior]({%slug grid-columns-width%}) article.
19-
* Set the `RowHeight` parameter so that the content fits. For more information see the [Notes](#notes) section.
19+
* Set the `RowHeight` so that the content of all cells fit in the row. For more information see the [Notes](#notes) section.
20+
* Set the `Height` of the Grid in `px`. For more information see the [Notes](#notes) section.
2021

2122

2223
This article will be separated in the following sections:
@@ -32,12 +33,12 @@ The targeted scenario is for Grid with big volume of columns, since the performa
3233

3334
>caption Basic setup of the Virtual Columns
3435
35-
3636
````CSHTML
3737
@*Observe the behavior of the Grid with enabled ColumnVirtualization*@
3838
3939
<TelerikGrid Data="@MyData"
4040
Width="800px"
41+
Height="400px"
4142
RowHeight="65"
4243
ColumnVirtualization="true"
4344
Pageable="true" PageSize="5">
@@ -113,9 +114,9 @@ The targeted scenario is for Grid with big volume of columns, since the performa
113114

114115
## Virtual Columns and Rows
115116

116-
To use Virual Columns and Rows together you need to set `Height` parameter of the Grid. More information on Virtual Rows can be found in the [Virtual Scrolling]({%slug components/grid/virtual-scrolling%}) article.
117+
To use Virtualized Columns and Rows together you need to set `Height` parameter of the Grid as well. More information on Virtual Rows can be found in the [Virtual Scrolling]({%slug components/grid/virtual-scrolling%}) article.
117118

118-
>caption Use Virtual Columns and Rows together
119+
>caption Use Virtualized Columns and Rows together
119120
120121
````CSHTML
121122
@*Observe the behavior of the Grid with Virtual Rows and Columns*@
@@ -199,7 +200,7 @@ To use Virual Columns and Rows together you need to set `Height` parameter of th
199200

200201
## Virtual Autogenerated Columns
201202

202-
In order to add Virtual Autogenerated Columns, the `ColumnWidth` parameter must be set. For more information on Autogenerated columns you can read the [Automatically Generated Columns]({%slug grid-columns-automatically-generated%}) article.
203+
In order to add Virtualized Autogenerated Columns, the `ColumnWidth` parameter must be set. For more information on Autogenerated columns you can read the [Automatically Generated Columns]({%slug grid-columns-automatically-generated%}) article.
203204

204205
````CSHTML
205206
@*Grid with Virtual Autogenerated Columns*@
@@ -292,10 +293,11 @@ In order to add Virtual Autogenerated Columns, the `ColumnWidth` parameter must
292293
![gif of virtual columns](images/virtual-columns-autogenerated.gif)
293294

294295
## Notes
295-
* Rendering the Virtual Columns in Client-side Blazor Applications is slower due to the Framework rendering performance. In the Server-side Applications this issue is not present.
296-
* Setting `RowHeight` and `Height` is required because the grid could be dynamically resized during scrolling due to the way HTML handles with dynamic content.
296+
* Rendering the Virtual Columns in Client-side Blazor Applications is slower due to the Framework rendering limitations. In the Server-side Applications this issue is not present.
297+
* The `RowHeight` must accommodate the height of all the possible cells and their content in order to ensure good appearance. If certain cells that are not rendered have content that is taller than the rendered ones, you may experience glitches and unstable scrolling. If the row/cell height the browser would render is larger than the `RowHeight` value, the browser will ignore it. It can depend on the chosen Theme or other CSS rules, or on cell data that falls on more than one row. Inspect the rendered HTML to make sure the grid setting matches the rendering.
298+
* The `Height` of the Grid must be explicitly set in `px`. By default the Height is calculated. When a new row is rendered during horizontal scrolling it might increase the horizonal size of the Grid and cause issues with the rendering and abnormal visual behavior for the users.
299+
297300

298-
299301
## See also
300302
* [Live demo: Virtual Columns](https://demos.telerik.com/blazor-ui/grid/virtual-columns)
301303
* [Virtual Scrolling]({%slug components/grid/virtual-scrolling%})

0 commit comments

Comments
 (0)