Skip to content

Commit 0b8c82c

Browse files
svdimitrjivanova
authored andcommitted
docs(mc-combo): overview article minor fixes
1 parent cd2c5b3 commit 0b8c82c

File tree

1 file changed

+20
-23
lines changed

1 file changed

+20
-23
lines changed

components/multicolumncombobox/overview.md

Lines changed: 20 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ The Blazor MultiColumnComboBox allows you to define one or more columns in the d
6767

6868
## Filtering
6969

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 %}).
7171

7272
## Grouping
7373

@@ -88,7 +88,7 @@ The Blazor MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features
8888

8989
## Parameters
9090

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:
9292
9393
<style>
9494
article style + table {
@@ -98,13 +98,13 @@ The Blazor MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features
9898
</style>
9999
| Parameter | Type | Description
100100
| ----------- | ----------- | -----------|
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`.
102102
| `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`.
103103
| `Data` | `IEnumerable<TItem>` | allows you to provide the data source. Required.
104104
| `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.
105105
| `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.
108108
| `Id` | `string` | renders as the `id` attribute on the `<input />` element, so you can attach a `<label for="">` to the input.
109109
| `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.
110110
| `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
116116

117117
### Styling and Appearance
118118

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:
120120

121121
@[template](/_contentTemplates/dropdowns/features.md#styling)
122122

123-
You can find more options for customizing the ComboBox styling in the [Appearance article]({%slug combobox-appearance%}).
123+
You can find more options for customizing the MultiColumnComboBox styling in the [Appearance article]({%slug multicolumncombobox-appearance%}).
124124

125125

126126
### Popup settings
@@ -129,27 +129,27 @@ The popup of the component can be additionally customized via nested tags:
129129

130130
````
131131
<div class="skip-repl"></div>
132-
<TelerikComboBox>
133-
<ComboBoxSettings>
134-
<ComboBoxPopupSettings Height="..." />
135-
</ComboBoxSettings>
136-
</TelerikComboBox>
132+
<TelerikMultiColumnComboBox>
133+
<MultiColumnComboBoxSettings>
134+
<MultiColumnComboBoxPopupSettings Height="..." />
135+
</MultiColumnComboBoxSettings>
136+
</TelerikMultiColumnComboBox>
137137
````
138138

139-
The ComboBox provides the following popup settings:
139+
The MultiColumnComboBox provides the following popup settings:
140140

141141
@[template](/_contentTemplates/dropdowns/features.md#popup-settings)
142142

143143

144144
## Selected Item
145145

146-
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.
147147

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:
149149

150150
* the user clears the value through the Clear button,
151151
* 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.
153153
* `AllowCustom="true"` - when the user starts typing a custom value.
154154

155155

@@ -169,14 +169,11 @@ Missing selection is most common when the initial value is `null` as data source
169169

170170
## Next Steps
171171

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%})
175173

176174
## See Also
177175

178-
* [Data Binding]({%slug components/combobox/databind%})
179-
* [Live Demo: ComboBox](https://demos.telerik.com/blazor-ui/combobox/overview)
180-
* [Live Demo: ComboBox Validation](https://demos.telerik.com/blazor-ui/combobox/validation)
181-
* [API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.Components.TelerikComboBox-2)
176+
* [Data Binding]({% slug multicolumncombobox-data-binding %})
177+
* [Live Demo: MultiColumnComboBox](https://demos.telerik.com/blazor-ui/multicolumncombobox/overview)
178+
* [Live Demo: MultiColumnComboBox Validation](https://demos.telerik.com/blazor-ui/multicolumncombobox/validation)
182179

0 commit comments

Comments
 (0)