docs(autoComplete): filter operator

Author: marin-bratanov

components/autocomplete/filter.md

@@ -12,7 +12,9 @@ position: 3
 
 The AutoComplete component can filter the available suggestions according to the current user input, so they can find the one they need faster. To see the difference in behavior, visit the [Live Demo: AutoComplete Filtering](https://demos.telerik.com/blazor-ui/autocomplete/filtering) page.
 
-To enable filtering, set the `Filterable` parameter to `true`. The filter operator is `starts with`, and it ignores casing.
+To enable filtering, set the `Filterable` parameter to `true`.
+
+Filtering ignores casing and the default filter operator is `starts with`. You can choose a different operator through the `FilterOperator` parameter that takes a member of the `Telerik.Blazor.StringFilterOperator` enum.
 
 To control when the filter list appears, set the `MinLength` parameter. This can be useful if you have a very large list of data.
 
@@ -52,6 +54,33 @@ To control when the filter list appears, set the `MinLength` parameter. This can
 }
 ````
 
+
+>caption Choose FilterOperator
+
+````CSHTML
+<label>
+    Choose filter operator:
+    <select @bind="filterOperator">
+        @foreach (var possibleFilter in Enum.GetValues(typeof(StringFilterOperator)))
+        {
+            <option value="@possibleFilter">@possibleFilter</option>
+        }
+    </select>
+</label>
+<TelerikAutoComplete Data="@Suggestions" @bind-Value="@TheValue"
+                     Filterable="true" FilterOperator="@filterOperator"
+                     Placeholder="Write 's' or 'a' to see the difference" ClearButton="true" />
+
+@code{
+    string TheValue { get; set; }
+    StringFilterOperator filterOperator { get; set; } = StringFilterOperator.StartsWith;
+
+    List<string> Suggestions { get; set; } = new List<string> {
+        "Manager", "Developer", "QA", "Technical Writer", "Support Engineer", "Sales Agent", "Architect", "Designer"
+    };
+}
+````
+
 ## See Also
 
   * [Live Demo: AutoComplete Filtering](https://demos.telerik.com/blazor-ui/autocomplete/filtering)

components/autocomplete/overview.md

@@ -52,6 +52,7 @@ The AutoComplete is a generic component and its type is determined by the type o
 * `Data` - allows you to provide the data source. Required.
 * `Enabled` - whether the component is enabled.
 * `Filterable` - whether [filtering]({%slug autocomplete-filter%}) is enabled for the end user (suggestions will get narrowed down as they type).
+* `FilterOperator` - the string operation that will be used for [filtering]({%slug autocomplete-filter%}). Defaults to `StartsWith`.
 * `MinLength` - how many characters the text has to be before the suggestions list appears. Cannot be `0`. Often works together with [filtering]({%slug autocomplete-filter%}).
 * `Placeholder` - the text the user sees as a hint when there is no text in the input.
 * `PopupHeight` - the height of the expanded dropdown list element.