API Proposal: QuickGrid OnRowClick EventCallback

[javiercn]

Background and Motivation

QuickGrid lacks a built-in way to handle row click events. This is a very common scenario — developers want to navigate to a detail page or perform an action when a grid row is clicked. Issue #44899 has 33+ upvotes requesting this feature. Currently developers must use TemplateColumn with buttons or other workarounds.

PR #64602, fixes #44899. Adds OnRowClick EventCallback to QuickGrid.

Proposed API

namespace Microsoft.AspNetCore.Components.QuickGrid;

public partial class QuickGrid<TGridItem>
{
+    [Parameter] public EventCallback<TGridItem> OnRowClick { get; set; }
}

When OnRowClick is set, row elements receive a row-clickable CSS class and cursor: pointer style.

Usage Examples

<QuickGrid Items="@people" OnRowClick="HandleRowClick">
    <PropertyColumn Property="@(p => p.Name)" />
</QuickGrid>

@code {
    void HandleRowClick(Person person)
    {
        NavigationManager.NavigateTo($"/people/{person.Id}");
    }
}

Alternative Designs

Using TemplateColumn with an explicit button/link in each row. This requires more markup and doesn't provide the full-row click affordance.

Risks

None — additive parameter. When not set, behavior is unchanged.

[github-actions]

Triage Summary

Area: area-blazor (QuickGrid is part of src/Components/QuickGrid/ — already labeled)
Type: api-proposal (formal API proposal following the standard template, with proposed diff, usage examples, alternatives, and risks sections)

Potential Duplicates

• QuickGrid: Add EventCallback<TGridItem> for clicking on a row. #44899 - "QuickGrid: Add EventCallback for clicking on a row." — the original feature request (33+ upvotes) that this API proposal directly addresses; already closed as completed. Not a duplicate — this issue is the formal API review step.
• No other open duplicates found.

Notes

• PR [Blazor] Add OnRowClick EventCallback to QuickGrid #64602 is already open implementing this change.
• The proposed API surface is EventCallback<TGridItem> OnRowClick on QuickGrid<TGridItem> — purely additive with no behavior change when the parameter is unset.
• The api-ready-for-review label is already applied, indicating this is ready for the API review board.

Generated by Issue Triage Agent for dotnet/aspnetcore for issue #66389 · ● 214.6K · ◷

[halter73]

API Review Notes:

• Can you get an index for the row?
  • No. It has to work with things like IEnumerable where we don't always have an index.
• Can you distinguish between left and right clicks?
  • No. But can we use MouseEventArgs.
• Can we add index and MouseEventArgs via a struct we use in EventCallback<TValue>?
  • It would be non-standard. It's usually EventCallback<TGridItem> elsewhere.
• Should we be more worried that this API isn't really accessible?
  • "A clickable is not keyboard-operable, not announced as interactive by screen readers, and adding role="button" breaks table semantics. The proposal only mentions a cursor: pointer style.
  • Does the implementation add tabindex="0" on clickable rows and handle Enter/Space to invoke the callback?
  • What ARIA story are we committing to? (aria-rowindex, focus ring, role considerations.)
  • How does this interact with existing focusable content in cells (tab order)?
  • We still want to ship APIs that people need even if they aren't directly accessible. However, we should make it as easy as possible to make an accessible app.

API approved as proposed!

namespace Microsoft.AspNetCore.Components.QuickGrid;

public partial class QuickGrid<TGridItem>
{
+    [Parameter] public EventCallback<TGridItem> OnRowClick { get; set; }
}