Skip to content

[On hold] docs(Grid): add filter, sort and group tools #2945

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

xristianstefanov
Copy link
Contributor

@xristianstefanov xristianstefanov commented May 9, 2025

Closes: https://github.com/telerik/blazor/issues/11117

//NOTE: There are still things waiting to be pushed

@xristianstefanov xristianstefanov self-assigned this May 9, 2025
@xristianstefanov xristianstefanov requested review from a team as code owners May 9, 2025 11:19
@xristianstefanov xristianstefanov changed the title docs(Grid): add filter, sort and group tools [On hold] docs(Grid): add filter, sort and group tools May 9, 2025
@@ -161,6 +161,7 @@ The following table lists Grid parameters, which are not discussed elsewhere in

| Parameter | Type and Default Value | Description |
| --- | --- | --- |
| `AdaptiveMode` | `AdaptiveMode` enum <br /> (`None`) | Defines the adaptive mode of the Grid. When set to `Auto`, and the window width is below `768px` or `RootComponentAdaptiveSettings.Medium`, components with popups will render them as an `ActionSheet`. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You may want to use "adaptive mode" as an anchor leading to an article or a section dedicated to that topic.

@@ -25,6 +25,9 @@ The [Blazor Grid](https://demos.telerik.com/blazor-ui/grid/overview) provides se
| Add | `GridToolBarAddTool` | An add command that fires the [`OnAdd` event](slug:grid-editing-overview#events). |
| CsvExport | `GridToolBarCsvExportTool` | An export command for CSV files that fires the [`OnBeforeExport` event](slug:grid-export-events#onbeforeexport). |
| ExcelExport | `GridToolBarExcelExportTool` | An export command for Excel files that fires the [`OnBeforeExport` event](slug:grid-export-events#onbeforeexport). |
| Filter | `GridToolBarFilterTool` | A toggle button in the Grid’s toolbar that opens a filter interface. On desktop screens, it displays a popup with a filter menu; on mobile devices, it renders as an `ActionSheet`. The component has two views: one for selecting the column to filter, and another for applying the filter to the selected column. The tool also exposes `Icon` parameter that allows you to override the default icon. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Filter | `GridToolBarFilterTool` | A toggle button in the Grid’s toolbar that opens a filter interface. On desktop screens, it displays a popup with a filter menu; on mobile devices, it renders as an `ActionSheet`. The component has two views: one for selecting the column to filter, and another for applying the filter to the selected column. The tool also exposes `Icon` parameter that allows you to override the default icon. |
| Filter | `GridToolBarFilterTool` | A toggle button in the Grid’s toolbar that opens a filter interface. On desktop screens, it displays a popup with a filter menu; on mobile devices, it renders as an `ActionSheet`. The component has two views: one for selecting the column to filter, and another for applying the filter to the selected column. The tool also exposes an `Icon` parameter that allows you to override the default icon. |

@@ -25,6 +25,9 @@ The [Blazor Grid](https://demos.telerik.com/blazor-ui/grid/overview) provides se
| Add | `GridToolBarAddTool` | An add command that fires the [`OnAdd` event](slug:grid-editing-overview#events). |
| CsvExport | `GridToolBarCsvExportTool` | An export command for CSV files that fires the [`OnBeforeExport` event](slug:grid-export-events#onbeforeexport). |
| ExcelExport | `GridToolBarExcelExportTool` | An export command for Excel files that fires the [`OnBeforeExport` event](slug:grid-export-events#onbeforeexport). |
| Filter | `GridToolBarFilterTool` | A toggle button in the Grid’s toolbar that opens a filter interface. On desktop screens, it displays a popup with a filter menu; on mobile devices, it renders as an `ActionSheet`. The component has two views: one for selecting the column to filter, and another for applying the filter to the selected column. The tool also exposes `Icon` parameter that allows you to override the default icon. |
| Group | `GridToolBarGroupTool` | A toggle button in the Grid’s toolbar that opens a popup listing the groupable columns — click a column to group by it. On mobile devices, the popup is rendered as an `ActionSheet`. The tool also exposes `Icon` parameter that allows you to override the default icon. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Our style guide recommends using the em dash without spaces on either side.

Suggested change
| Group | `GridToolBarGroupTool` | A toggle button in the Grid’s toolbar that opens a popup listing the groupable columnsclick a column to group by it. On mobile devices, the popup is rendered as an `ActionSheet`. The tool also exposes `Icon` parameter that allows you to override the default icon. |
| Group | `GridToolBarGroupTool` | A toggle button in the Grid’s toolbar that opens a popup listing the groupable columnsclick a column to group by it. On mobile devices, the popup is rendered as an `ActionSheet`. The tool also exposes an `Icon` parameter that allows you to override the default icon. |

@@ -25,6 +25,9 @@ The [Blazor Grid](https://demos.telerik.com/blazor-ui/grid/overview) provides se
| Add | `GridToolBarAddTool` | An add command that fires the [`OnAdd` event](slug:grid-editing-overview#events). |
| CsvExport | `GridToolBarCsvExportTool` | An export command for CSV files that fires the [`OnBeforeExport` event](slug:grid-export-events#onbeforeexport). |
| ExcelExport | `GridToolBarExcelExportTool` | An export command for Excel files that fires the [`OnBeforeExport` event](slug:grid-export-events#onbeforeexport). |
| Filter | `GridToolBarFilterTool` | A toggle button in the Grid’s toolbar that opens a filter interface. On desktop screens, it displays a popup with a filter menu; on mobile devices, it renders as an `ActionSheet`. The component has two views: one for selecting the column to filter, and another for applying the filter to the selected column. The tool also exposes `Icon` parameter that allows you to override the default icon. |
| Group | `GridToolBarGroupTool` | A toggle button in the Grid’s toolbar that opens a popup listing the groupable columns — click a column to group by it. On mobile devices, the popup is rendered as an `ActionSheet`. The tool also exposes `Icon` parameter that allows you to override the default icon. |
| Sort | `GridToolBarSortTool` | A toggle button in the Grid’s toolbar that opens a popup listing the sortable columns — click a column to sort by it. On mobile devices, the popup is rendered as an `ActionSheet`. The tool also exposes `Icon` parameter that allows you to override the default icon. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Sort | `GridToolBarSortTool` | A toggle button in the Grid’s toolbar that opens a popup listing the sortable columnsclick a column to sort by it. On mobile devices, the popup is rendered as an `ActionSheet`. The tool also exposes `Icon` parameter that allows you to override the default icon. |
| Sort | `GridToolBarSortTool` | A toggle button in the Grid’s toolbar that opens a popup listing the sortable columnsclick a column to sort by it. On mobile devices, the popup is rendered as an `ActionSheet`. The tool also exposes an `Icon` parameter that allows you to override the default icon. |

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants