From 4f52cbbc8619d6166c23f649ba8dba034d57529e Mon Sep 17 00:00:00 2001 From: Ilona Tomkowicz Date: Wed, 29 Jul 2026 15:43:57 +0200 Subject: [PATCH 1/2] QuickGrid APIs from Virtualzie are exposed. --- aspnetcore/blazor/components/quickgrid.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/aspnetcore/blazor/components/quickgrid.md b/aspnetcore/blazor/components/quickgrid.md index c1622005b944..e1a0b3a73aad 100644 --- a/aspnetcore/blazor/components/quickgrid.md +++ b/aspnetcore/blazor/components/quickgrid.md @@ -5,7 +5,7 @@ author: guardrex description: The QuickGrid component is a Razor component for quickly and efficiently displaying data in tabular form. monikerRange: '>= aspnetcore-8.0' ms.author: wpickett -ms.date: 11/11/2025 +ms.date: 07/29/2026 uid: blazor/components/quickgrid --- # ASP.NET Core Blazor `QuickGrid` component @@ -43,6 +43,10 @@ To implement a `QuickGrid` component: * : Only applicable when using . defines an expected height in pixels for each row, allowing the virtualization mechanism to fetch the correct number of items to match the display size and to ensure accurate scrolling. * : Optionally defines a value for `@key` on each rendered row. Typically, this is used to specify a unique identifier, such as a primary key value, for each data item. This allows the grid to preserve the association between row elements and data items based on their unique identifiers, even when the `TGridItem` instances are replaced by new copies (for example, after a new query against the underlying data store). If not set, the `@key` is the `TGridItem` instance. * : Defines how many additional items to render before and after the visible region to reduce rendering frequency during scrolling. While higher values can improve scroll smoothness by rendering more items off-screen, a higher value can also result in an increase in initial load times. Finding a balance based on your data set size and user experience requirements is recommended. The default value is `3`. Only available when using . +* : Only applicable when using . Scrolls the grid to the given zero-based row index on the first interactive render. The value is applied once and clamped to the valid range. This forwards to the inner `Virtualize` component. For more information, see . +* : Only applicable when using . Programmatically scrolls the grid to the given zero-based row index, aligning it to the top. The last call wins, and the method throws an when virtualization is disabled or the grid isn't rendered yet. This forwards to the inner `Virtualize` component. For more information, see . +* : Only applicable when using . Controls how the viewport behaves at list edges when items are dynamically added (default: `Start`). This is an experimental API that requires opting in to the `ASP0030` diagnostic, and it forwards to the inner `Virtualize` component. For more information, see . +* : Only applicable when using . A comparer used to detect whether items were prepended or appended between data loads, which is useful for class-typed items supplied by an . This is an experimental API that requires opting in to the `ASP0030` diagnostic, and it forwards to the inner `Virtualize` component. For more information, see . * : Optionally links this `TGridItem` instance with a model, causing the grid to fetch and render only the current page of data. This is normally used in conjunction with a component or some other UI logic that displays and updates the supplied instance. includes API for interacting with the current zero-based page index, the number of items on each page, the zero-based index of the last page, and the total number of items across all pages. * In the QuickGrid child content (), specify s, which represent `TGridItem` columns whose cells display values: * : Defines the value to be displayed in this column's cells. From 5b6679d1c7c0ac5021fd1760bdd725462502a658 Mon Sep 17 00:00:00 2001 From: Luke Latham <1622880+guardrex@users.noreply.github.com> Date: Wed, 29 Jul 2026 10:18:47 -0400 Subject: [PATCH 2/2] Set aside the XREF API cross-links until GA Updated QuickGrid component documentation to include new API cross-links and descriptions for additional properties. --- aspnetcore/blazor/components/quickgrid.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/aspnetcore/blazor/components/quickgrid.md b/aspnetcore/blazor/components/quickgrid.md index e1a0b3a73aad..396581fa589e 100644 --- a/aspnetcore/blazor/components/quickgrid.md +++ b/aspnetcore/blazor/components/quickgrid.md @@ -30,7 +30,14 @@ To implement a `QuickGrid` component: :::moniker range=">= aspnetcore-11.0" - + * Specify tags for the `QuickGrid` component in Razor markup (`...`). * Name a queryable source of data for the grid. Use ***either*** of the following data sources: @@ -43,10 +50,10 @@ To implement a `QuickGrid` component: * : Only applicable when using . defines an expected height in pixels for each row, allowing the virtualization mechanism to fetch the correct number of items to match the display size and to ensure accurate scrolling. * : Optionally defines a value for `@key` on each rendered row. Typically, this is used to specify a unique identifier, such as a primary key value, for each data item. This allows the grid to preserve the association between row elements and data items based on their unique identifiers, even when the `TGridItem` instances are replaced by new copies (for example, after a new query against the underlying data store). If not set, the `@key` is the `TGridItem` instance. * : Defines how many additional items to render before and after the visible region to reduce rendering frequency during scrolling. While higher values can improve scroll smoothness by rendering more items off-screen, a higher value can also result in an increase in initial load times. Finding a balance based on your data set size and user experience requirements is recommended. The default value is `3`. Only available when using . -* : Only applicable when using . Scrolls the grid to the given zero-based row index on the first interactive render. The value is applied once and clamped to the valid range. This forwards to the inner `Virtualize` component. For more information, see . -* : Only applicable when using . Programmatically scrolls the grid to the given zero-based row index, aligning it to the top. The last call wins, and the method throws an when virtualization is disabled or the grid isn't rendered yet. This forwards to the inner `Virtualize` component. For more information, see . -* : Only applicable when using . Controls how the viewport behaves at list edges when items are dynamically added (default: `Start`). This is an experimental API that requires opting in to the `ASP0030` diagnostic, and it forwards to the inner `Virtualize` component. For more information, see . -* : Only applicable when using . A comparer used to detect whether items were prepended or appended between data loads, which is useful for class-typed items supplied by an . This is an experimental API that requires opting in to the `ASP0030` diagnostic, and it forwards to the inner `Virtualize` component. For more information, see . +* `InitialItemIndex`: Only applicable when using . Scrolls the grid to the given zero-based row index on the first interactive render. The value is applied once and clamped to the valid range. This forwards to the inner `Virtualize` component. For more information, see . +* `ScrollToItemAsync`: Only applicable when using . Programmatically scrolls the grid to the given zero-based row index, aligning it to the top. The last call wins, and the method throws an when virtualization is disabled or the grid isn't rendered yet. This forwards to the inner `Virtualize` component. For more information, see . +* `AnchorMode`: Only applicable when using . Controls how the viewport behaves at list edges when items are dynamically added (default: `Start`). This is an experimental API that requires opting in to the `ASP0030` diagnostic, and it forwards to the inner `Virtualize` component. For more information, see . +* `ItemComparer`: Only applicable when using . A comparer used to detect whether items were prepended or appended between data loads, which is useful for class-typed items supplied by an . This is an experimental API that requires opting in to the `ASP0030` diagnostic, and it forwards to the inner `Virtualize` component. For more information, see . * : Optionally links this `TGridItem` instance with a model, causing the grid to fetch and render only the current page of data. This is normally used in conjunction with a component or some other UI logic that displays and updates the supplied instance. includes API for interacting with the current zero-based page index, the number of items on each page, the zero-based index of the last page, and the total number of items across all pages. * In the QuickGrid child content (), specify s, which represent `TGridItem` columns whose cells display values: * : Defines the value to be displayed in this column's cells.