Skip to content

Commit 0ce6ba8

Browse files
svdimitrjivanova
authored andcommitted
docs(mc-combo): grouping article
1 parent bf67eb6 commit 0ce6ba8

File tree

1 file changed

+16
-12
lines changed

1 file changed

+16
-12
lines changed

components/multicolumncombobox/grouping.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,35 @@
11
---
22
title: Grouping
3-
page_title: ComboBox - Grouping
4-
description: Grouping in the ComboBox for Blazor.
5-
slug: components/combobox/grouping
6-
tags: telerik,blazor,combo,combobox,group,grouping
3+
page_title: MultiColumnComboBox - Grouping
4+
description: Grouping in the MultiColumnComboBox for Blazor.
5+
slug: multicolumncombobox-grouping
6+
tags: telerik,blazor,multicolumncombobox,combobox,group,grouping
77
published: True
88
position: 15
99
---
1010

11-
# ComboBox Grouping
11+
# MultiColumnComboBox Grouping
1212

13-
The ComboBox component allows users to see the listed items grouped in categories. This can improve the user experience and make browsing through the items faster.
13+
The MultiColumnComboBox component allows users to see the listed items grouped in categories. This can improve the user experience and make browsing through the items faster.
1414

15-
To enable ComboBox grouping, set the `GroupField` parameter to a field name from the model. The ComboBox will display the corresponding field values as group headers in the dropdown. Nested values of complex object properties are supported (see the example below).
15+
To enable MultiColumnComboBox grouping, set the `GroupField` parameter to a field name from the model. The MultiColumnComboBox will display the corresponding field values as group headers in the dropdown. Nested values of complex object properties are supported (see the example below).
1616

1717
The group headers can stick to the top of the dropdown during scrolling. In other words, users will always know which is the group of the current topmost items in the scrollable list.
1818

19-
>caption Grouping in the ComboBox
19+
>caption Grouping in the MultiColumnComboBox
2020
2121
````CSHTML
22-
<TelerikComboBox Data="@Data"
22+
<TelerikMultiColumnComboBox Data="@Data"
2323
@bind-Value="@SelectedValue"
2424
GroupField="Category.CategoryName"
2525
TextField="ProductName"
2626
ValueField="ProductId"
2727
Placeholder="Select a product">
28-
</TelerikComboBox>
28+
<MultiColumnComboBoxColumns>
29+
<MultiColumnComboBoxColumn Field="@nameof(Product.ProductId)"></MultiColumnComboBoxColumn>
30+
<MultiColumnComboBoxColumn Field="@nameof(Product.ProductName)"></MultiColumnComboBoxColumn>
31+
</MultiColumnComboBoxColumns>
32+
</TelerikMultiColumnComboBox>
2933
3034
@code {
3135
public IEnumerable<Product> Data { get; set; }
@@ -68,10 +72,10 @@ The group headers can stick to the top of the dropdown during scrolling. In othe
6872

6973
* One level of grouping is supported.
7074
* The `DefaultItem` (e.g. "Select item...") is always rendered above the sticky group header in the dropdown.
71-
* A grouped ComboBox will provide a `Groups` property with a single [`GroupDescriptor`](https://docs.telerik.com/blazor-ui/api/Telerik.DataSource.GroupDescriptor) in the [`DataSourceRequest`](https://docs.telerik.com/blazor-ui/api/Telerik.DataSource.DataSourceRequest) argument of its [OnRead event]({%slug components/combobox/events%}#onread). This will allow the developer to apply grouping with [manual data operations]({%slug components/grid/manual-operations%}).
75+
* A grouped MultiColumnComboBox will provide a `Groups` property with a single [`GroupDescriptor`](https://docs.telerik.com/blazor-ui/api/Telerik.DataSource.GroupDescriptor) in the [`DataSourceRequest`](https://docs.telerik.com/blazor-ui/api/Telerik.DataSource.DataSourceRequest) argument of its [OnRead event]({%slug multicolumncombobox-events%}#onread). This will allow the developer to apply grouping with [manual data operations]({%slug components/grid/manual-operations%}).
7276
* `GroupHeaderTemplate` and `GroupItemTemplate` will be introduced in a future version. Currently there is a bug in the Blazor framework that prevents us from supporting them.
7377
* Virtual scrolling with grouping will be supported in a future version.
7478

7579
## See Also
7680

77-
* [Live Demo: ComboBox Grouping](https://demos.telerik.com/blazor-ui/combobox/grouping)
81+
* [Live Demo: ComboBox Grouping](https://demos.telerik.com/blazor-ui/multicolumncombobox/grouping)

0 commit comments

Comments
 (0)