You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: components/multicolumncombobox/overview.md
+20-23Lines changed: 20 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -67,7 +67,7 @@ The Blazor MultiColumnComboBox allows you to define one or more columns in the d
67
67
68
68
## Filtering
69
69
70
-
The Blazor MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features.md#filtering)[Read more about the Blazor ComboBox filter...]({% slug cmulticolumncombobox-filter %}).
70
+
The Blazor MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features.md#filtering)[Read more about the Blazor ComboBox filter...]({% slug multicolumncombobox-filter %}).
71
71
72
72
## Grouping
73
73
@@ -88,7 +88,7 @@ The Blazor MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features
88
88
89
89
## Parameters
90
90
91
-
>caption The ComboBox provides various parameters that allow you to configure the component:
91
+
>caption The MultiColumnComboBox provides various parameters that allow you to configure the component:
92
92
93
93
<style>
94
94
articlestyle+table {
@@ -98,13 +98,13 @@ The Blazor MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features
98
98
</style>
99
99
| Parameter | Type | Description
100
100
| ----------- | ----------- | -----------|
101
-
| `AllowCustom` | `bool` | whether the user can enter [custom values]({%slug components/combobox/custom-value%}). If enabled, the `ValueField` must be a `string`.
101
+
| `AllowCustom` | `bool` | whether the user can enter [custom values]({%slug multicolumncombobox-custom-value%}). If enabled, the `ValueField` must be a `string`.
102
102
| `ClearButton` | `bool` | whether the user will have the option to clear the selected value. When it is clicked, the `Value` will be updated to `default(TValue)`, so there must be no item in the `Data` that has such a `Value`. For example, if `TValue` is `int`, clearing the value will lead to a `0``Value`, so if there is an Item with `0` in its `ValueField` - issues may arise with its selection. This feature can often go together with `AllowCustom`.
103
103
| `Data` | `IEnumerable<TItem>` | allows you to provide the data source. Required.
104
104
| `DebounceDelay` | `int` <br/> 150 | Time in milliseconds between the last typed symbol and the internal `oninput` event firing. Applies when the user types and filters. Use it to balance between client-side performance and number of database queries.
105
105
| `Enabled` | `bool` | whether the component is enabled.
106
-
|`Filterable` | `bool` | whether [filtering]({%slug components/combobox/filter%}) is enabled for the end user.
107
-
| `FilterOperator` | `StringFilterOperator` <br /> (`StartsWith`) | the method of [filtering]({%slug components/combobox/filter%}) the items.
106
+
|`Filterable` | `bool` | whether [filtering]({%slug multicolumncombobox-filter%}) is enabled for the end user.
107
+
| `FilterOperator` | `StringFilterOperator` <br /> (`StartsWith`) | the method of [filtering]({%slug multicolumncombobox-filter%}) the items.
108
108
| `Id` | `string` | renders as the `id` attribute on the `<input />` element, so you can attach a `<label for="">` to the input.
109
109
| `Placeholder` | `string` | the text the user sees as a hint when no item is selected. In order for it to be shown, the `Value` parameter should be set to a default value depending on the type defined in the `ValueField` parameter. For example, `0` for an `int`, and `null` for an `int?` or `string`. You need to make sure that it does not match the value of an existing item in the data source.
110
110
| `TItem` | `Type` | the type of the model to which the component is bound. Required if you can't provide `Data` or `Value`. Determines the type of the reference object.
@@ -116,11 +116,11 @@ The Blazor MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features
116
116
117
117
### Styling and Appearance
118
118
119
-
The following parameters enable you to customize the appearance of the Blazor ComboBox:
119
+
The following parameters enable you to customize the appearance of the Blazor MultiColumnComboBox:
By default, if no `Value` is provided, the ComboBox will appear empty, or will display the `Placeholder` defined. If a `Value` is provided and `AllowCustom` is *not* set to `true`, the `Value` should match an item in the data source (see more in the [Value Out of Range]({%slug components/combobox/databind%}#value-out-of-range) section).
146
+
By default, if no `Value` is provided, the MultiColumnComboBox will appear empty, or will display the `Placeholder` defined. If a `Value` is provided and `AllowCustom` is *not* set to `true`, the `Value` should match an item in the data source (see more in the [Value Out of Range]({%slug multicolumncombobox-data-binding%}#value-out-of-range) section.
147
147
148
-
The ComboBox will not always have a selected item, however, because it can act as an input. There will be no selected item in the following cases that depend on the settings of the component that the developer can control:
148
+
The MultiColumnComboBox will not always have a selected item, however, because it can act as an input. There will be no selected item in the following cases that depend on the settings of the component that the developer can control:
149
149
150
150
* the user clears the value through the Clear button,
151
151
* the user clears the value with `Backspace` or `Del` keys,
152
-
*`AllowCustom="false"` - when a custom value is typed, the ComboBox input value will be automatically cleared on the change event (`blur` of the input or `Enter` keypress). See the table below.
152
+
*`AllowCustom="false"` - when a custom value is typed, the MultiColumnComboBox input value will be automatically cleared on the change event (`blur` of the input or `Enter` keypress). See the table below.
153
153
*`AllowCustom="true"` - when the user starts typing a custom value.
154
154
155
155
@@ -169,14 +169,11 @@ Missing selection is most common when the initial value is `null` as data source
169
169
170
170
## Next Steps
171
171
172
-
*[Binding the ComboBox to Data]({%slug components/combobox/databind%})
173
-
174
-
*[Pre-Selecting Items for the User]({% slug combobox-pre-select-item %})
172
+
*[Binding the MultiColumnComboBox to Data]({%slug multicolumncombobox-data-binding%})
0 commit comments