Skip to content

Commit 40c2c6e

Browse files
Merge pull request #756 from AvaloniaUI/755-in-page-improving-performance-are-the-information-still-correct
Update TreeDataGrid documentation with notices and crosslinks to Accelerate
2 parents 66900b2 + 0178418 commit 40c2c6e

File tree

15 files changed

+70
-15
lines changed

15 files changed

+70
-15
lines changed

docs/guides/development-guides/improving-performance.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ When you need to display a large amount of data in a `DataGrid` or a `TreeView`
1515

1616
Avoid using the `DataGrid` control if you don't need editing features. It's generally regarded as a less optimal control for performance.
1717

18+
:::warning
19+
[`TreeDataGrid`](/accelerate/welcome) is maintained as part of Avalonia Accelerate as of October 2025. It is presently still the recommended option for large datasets.
20+
:::
21+
1822
## Virtualization
1923

2024
When working with large amounts of data, enabling virtualization can improve the performance of your Avalonia application. Virtualization means that only the visible items in the control are rendered, which significantly improves the performance when there are a large number of items to display.
@@ -23,6 +27,10 @@ When working with large amounts of data, enabling virtualization can improve the
2327

2428
`TreeDataGrid` supports virtualization and can handle thousands of rows with complex cells effectively.
2529

30+
:::warning
31+
[`TreeDataGrid`](/accelerate/welcome) is maintained as part of Avalonia Accelerate as of October 2025. It is presently still the recommended option for large datasets.
32+
:::
33+
2634
## Optimize Your Visual Tree Structure
2735

2836
Performance can often be hindered by a deeply nested and complicated layout. Strive to maintain your XAML markup as uncomplicated and flat as possible. Rendering UI elements onscreen triggers a "layout pass" twice for every single element (a measure pass followed by an arrange pass).

docs/reference/controls/treedatagrid/README.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,11 @@ import TreeDataGridNuGetScreenshot from '/img/reference/controls/treedatagrid/tr
1111

1212
The `TreeDataGrid` displays hierarchical and tabular data together in a single view. It is a combination of a tree view and data grid.
1313

14-
:::info
15-
For full information on the tree view control, see the reference [here](../treeview-1.md).
14+
:::warning
15+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for TreeDataGrid](/accelerate/components/treedatagrid/quickstart).
1616
:::
1717

18-
:::info
19-
For full information on the data grid control, see the reference [here](../datagrid/).
20-
:::
18+
See the reference pages for more information on the [tree view control](../treeview-1.md) and the [data grid control](../datagrid/).
2119

2220
The control has two modes of operation:
2321

docs/reference/controls/treedatagrid/creating-a-flat-treedatagrid.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ import FlatTreeDataGridSourceScreenshot from '/img/reference/controls/treedatagr
66

77
# Flat Tree Data Grid
88

9+
:::warning
10+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for flat `TreeDataGrid`](/accelerate/components/treedatagrid/quickstart-flat).
11+
:::
12+
913
## Example
1014

1115
In this example the view model contains an observable collection that is filled with data and then used to create a `FlatTreeDataGridSource` property to bind to the source of the tree data grid. The items of the grid are class `Person`.

docs/reference/controls/treedatagrid/creating-a-hierarchical-treedatagrid.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,13 @@ description: REFERENCE - Built-in Controls
44

55
import HierarchicalTreeDataGridSourceScreenshot from '/img/reference/controls/treedatagrid/treedatagrid-hierarchical.gif';
66

7+
78
# Hierarchical Tree Data Grid
89

10+
:::warning
11+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for hierarchical `TreeDataGrid`](/accelerate/components/treedatagrid/quickstart-hierarchical).
12+
:::
13+
914
## Example
1015

1116
In this example the view model contains an observable collection that is filled with data and then used to create a `HierarchicalTreeDataGridSource` property to bind on to the source of the tree data grid. The items of the grid are class `Person`.

docs/reference/controls/treedatagrid/treedatagrid-column-types.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@ description: REFERENCE - Built-in Controls
44

55
# Tree Data Grid Column Types
66

7+
:::warning
8+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for `TreeDataGrid` column types](/accelerate/components/treedatagrid/column-types).
9+
:::
10+
711
The tree data grid supports three different column types:
812

913
* Text Column

i18n/ru/docusaurus-plugin-content-docs/current/guides/development-guides/improving-performance.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ When you need to display a large amount of data in a `DataGrid` or a `TreeView`
1515

1616
Avoid using the `DataGrid` control if you don't need editing features. It's generally regarded as a less optimal control for performance.
1717

18+
:::warning
19+
[`TreeDataGrid`](/accelerate/welcome) is maintained as part of Avalonia Accelerate as of October 2025. It is presently still the recommended option for large datasets.
20+
:::
21+
1822
## Virtualization
1923

2024
When working with large amounts of data, enabling virtualization can improve the performance of your Avalonia application. Virtualization means that only the visible items in the control are rendered, which significantly improves the performance when there are a large number of items to display.
@@ -23,6 +27,10 @@ When working with large amounts of data, enabling virtualization can improve the
2327

2428
`TreeDataGrid` supports virtualization and can handle thousands of rows with complex cells effectively.
2529

30+
:::warning
31+
[`TreeDataGrid`](/accelerate/welcome) is maintained as part of Avalonia Accelerate as of October 2025. It is presently still the recommended option for large datasets.
32+
:::
33+
2634
## Optimize Your Visual Tree Structure
2735

2836
Performance can often be hindered by a deeply nested and complicated layout. Strive to maintain your XAML markup as uncomplicated and flat as possible. Rendering UI elements onscreen triggers a "layout pass" twice for every single element (a measure pass followed by an arrange pass).

i18n/ru/docusaurus-plugin-content-docs/current/reference/controls/detailed-reference/treedatagrid/README.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,11 @@ import TreeDataGridNuGetScreenshot from '/img/reference/controls/treedatagrid/tr
1010

1111
The tree data grid displays hierarchical and tabular data together in a single view. It is a combination of a tree view and data grid.
1212

13-
:::info
14-
For full information on the tree view control, see the reference [here](../treeview-1.md).
13+
:::warning
14+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for TreeDataGrid](/accelerate/components/treedatagrid/quickstart).
1515
:::
1616

17-
:::info
18-
For full information on the data grid control, see the reference [here](../../datagrid/).
19-
:::
17+
See the reference pages for more information on the [tree view control](../treeview-1.md) and the [data grid control](../datagrid/).
2018

2119
The control has two modes of operation:
2220

i18n/ru/docusaurus-plugin-content-docs/current/reference/controls/detailed-reference/treedatagrid/creating-a-flat-treedatagrid.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ import FlatTreeDataGridSourceScreenshot from '/img/reference/controls/treedatagr
66

77
# Flat Tree Data Grid
88

9+
:::warning
10+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for flat `TreeDataGrid`](/accelerate/components/treedatagrid/quickstart-flat).
11+
:::
12+
913
## Example
1014

1115
In this example the view model contains an observable collection that is filled with data and then used to create a `FlatTreeDataGridSource` property to bind to the source of the tree data grid. The items of the grid are class `Person`.

i18n/ru/docusaurus-plugin-content-docs/current/reference/controls/detailed-reference/treedatagrid/creating-a-hierarchical-treedatagrid.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ import HierarchicalTreeDataGridSourceScreenshot from '/img/reference/controls/tr
66

77
# Hierarchical Tree Data Grid
88

9+
:::warning
10+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for hierarchical `TreeDataGrid`](/accelerate/components/treedatagrid/quickstart-hierarchical).
11+
:::
12+
913
## Example
1014

1115
In this example the view model contains an observable collection that is filled with data and then used to create a `HierarchicalTreeDataGridSource` property to bind on to the source of the tree data grid. The items of the grid are class `Person`.

i18n/ru/docusaurus-plugin-content-docs/current/reference/controls/detailed-reference/treedatagrid/treedatagrid-column-types.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@ description: REFERENCE - Built-in Controls
44

55
# Tree Data Grid Column Types
66

7+
:::warning
8+
`TreeDataGrid` is maintained as part of Avalonia Accelerate as of October 2025. See the [Accelerate documentation for `TreeDataGrid` column types](/accelerate/components/treedatagrid/column-types).
9+
:::
10+
711
The tree data grid supports three different column types:
812

913
* Text Column

0 commit comments

Comments
 (0)