From 925e662b4b37a667447ae431898ed17edb37a8e2 Mon Sep 17 00:00:00 2001 From: Nadezhda Tacheva <73842592+ntacheva@users.noreply.github.com> Date: Wed, 13 Nov 2024 16:59:48 +0200 Subject: [PATCH 001/392] Update CODEOWNERS (#2528) --- CODEOWNERS | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/CODEOWNERS b/CODEOWNERS index 5e01936d0a..5fb839a959 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -1,3 +1 @@ -* @telerik/blazor-docs-admins -* @telerik/blazor-support -* @telerik/docs-reviewers +* @telerik/blazor-support @telerik/blazor-docs-admins @telerik/docs-reviewers From f11ea448853db2f3142791129fcc5b0a16a2755b Mon Sep 17 00:00:00 2001 From: Nadezhda Tacheva <73842592+ntacheva@users.noreply.github.com> Date: Wed, 13 Nov 2024 17:05:03 +0200 Subject: [PATCH 002/392] Update CODEOWNERS (#2529) --- CODEOWNERS | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CODEOWNERS b/CODEOWNERS index 5fb839a959..b2dd11774b 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -1 +1,3 @@ -* @telerik/blazor-support @telerik/blazor-docs-admins @telerik/docs-reviewers +* @telerik/blazor-support +* @telerik/blazor-docs-admins +* @telerik/docs-reviewers From ea2f42cae66e92bba861f3caf84b785dc63c28de Mon Sep 17 00:00:00 2001 From: Nadezhda Tacheva <73842592+ntacheva@users.noreply.github.com> Date: Wed, 13 Nov 2024 17:37:33 +0200 Subject: [PATCH 003/392] Update CODEOWNERS (#2530) * Update CODEOWNERS * Update CODEOWNERS --- CODEOWNERS | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/CODEOWNERS b/CODEOWNERS index b2dd11774b..402e7ab772 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -1,3 +1,4 @@ -* @telerik/blazor-support -* @telerik/blazor-docs-admins -* @telerik/docs-reviewers +* @telerik/blazor-support @telerik/blazor-docs-admins @telerik/docs-reviewers + +*.md @telerik/blazor-support @telerik/docs-reviewers +knowledge-base/* @telerik/blazor-support From 54f55ee88eed1926e9f85a6fcaf22090768782bc Mon Sep 17 00:00:00 2001 From: Nadezhda Tacheva <73842592+ntacheva@users.noreply.github.com> Date: Thu, 14 Nov 2024 14:37:35 +0200 Subject: [PATCH 004/392] Update CODEOWNERS (#2531) * Update CODEOWNERS * Update CODEOWNERS * chore(common): final codeowners update --- CODEOWNERS | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/CODEOWNERS b/CODEOWNERS index 402e7ab772..aacbfbf0e6 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -1,4 +1,19 @@ * @telerik/blazor-support @telerik/blazor-docs-admins @telerik/docs-reviewers *.md @telerik/blazor-support @telerik/docs-reviewers +*.cmd @telerik/blazor-support +*.config @telerik/blazor-support +*.conf @telerik/blazor-support +*.html @telerik/blazor-support +*.json @telerik/blazor-support +*.rb @telerik/blazor-support +*.yml @telerik/blazor-support knowledge-base/* @telerik/blazor-support +.github/* @telerik/blazor-support +_assetsApi/* @telerik/blazor-support +_tools/* @telerik/blazor-support +.gitignore @telerik/blazor-support +.spelling @telerik/blazor-support +CODEOWNERS @telerik/blazor-support +40x.html @telerik/blazor-support +all-pages.md @telerik/blazor-support From 1d837a54e68af52703938d0ea1cb202fbbaedcdc Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Fri, 15 Nov 2024 12:02:57 +0200 Subject: [PATCH 005/392] docs(treeview): Clarify Items nullability (#2533) --- .../data-binding/hierarchical-data.md | 82 +++++++++---------- components/treeview/data-binding/overview.md | 2 +- 2 files changed, 42 insertions(+), 42 deletions(-) diff --git a/components/treeview/data-binding/hierarchical-data.md b/components/treeview/data-binding/hierarchical-data.md index 124f4928c2..78175009e3 100644 --- a/components/treeview/data-binding/hierarchical-data.md +++ b/components/treeview/data-binding/hierarchical-data.md @@ -11,10 +11,10 @@ position: 2 # Treeview Data Binding to Hierarchical Data This article explains how to bind the TreeView for Blazor to hierarchical data. -@[template](/_contentTemplates/treeview/basic-example.md#data-binding-basics-link) +@[template](/_contentTemplates/treeview/basic-example.md#data-binding-basics-link) -Hierarchical data means that the child items are provided in a property of the parent item. By default, the TreeView expects this property to be called `Items`, otherwise set the property name in the `ItemsField` parameter. If a certain node has children, it will render an expand icon. The `HasChildren` model property can override this, but it is not required for hierarchical data binding. +Hierarchical data means that the child items are provided in a property of the parent item. By default, the TreeView expects this property to be called `Items`, otherwise set the property name in the `ItemsField` parameter. If a certain node has non-`null` child items collection, it will render an expand icon. The `HasChildren` model property can override this, but it is not required for hierarchical data binding. The hierarchical data binding approach allows you have separate collections of data or different model types at each TreeView level. Note that the data binding settings are per level, so a certain level will always use the same bindings, regardless of the model they represent and their parent. @@ -33,58 +33,58 @@ The example below uses two levels of hierarchy, but the same idea applies to any Hierarchical data hold collections of the child items - - - - + + + + @code { - public IEnumerable HierarchicalData { get; set; } - public IEnumerable ExpandedItems { get; set; } = new List(); + public IEnumerable HierarchicalData { get; set; } + public IEnumerable ExpandedItems { get; set; } = new List(); - public class ProductCategoryItem - { - public string Category { get; set; } - public List Products { get; set; } - } - - public class ProductItem - { - public string ProductName { get; set; } - } + public class ProductCategoryItem + { + public string Category { get; set; } + public List Products { get; set; } + } + public class ProductItem + { + public string ProductName { get; set; } + } - protected override void OnInitialized() - { - LoadHierarchical(); - ExpandedItems = HierarchicalData.Where(x => x.Products != null && x.Products.Any()).ToList(); - } - private void LoadHierarchical() - { - List roots = new List(); + protected override void OnInitialized() + { + LoadHierarchical(); + ExpandedItems = HierarchicalData.Where(x => x.Products != null && x.Products.Any()).ToList(); + } - List firstCategoryProducts = new List() + private void LoadHierarchical() { - new ProductItem { ProductName= "Category 1 - Product 1" }, - new ProductItem { ProductName= "Category 1 - Product 2" } - }; + List roots = new List(); - roots.Add(new ProductCategoryItem - { - Category = "Category 1", - Products = firstCategoryProducts // this is how child items are provided + List firstCategoryProducts = new List() + { + new ProductItem { ProductName= "Category 1 - Product 1" }, + new ProductItem { ProductName= "Category 1 - Product 2" } + }; - }); + roots.Add(new ProductCategoryItem + { + Category = "Category 1", + Products = firstCategoryProducts // this is how child items are provided - roots.Add(new ProductCategoryItem - { - Category = "Category 2" // we will set no other properties and it will not have children, nor will it be expanded - }); + }); - HierarchicalData = roots; - } + roots.Add(new ProductCategoryItem + { + Category = "Category 2" // we will set no other properties and it will not have children, nor will it be expanded + }); + + HierarchicalData = roots; + } } ```` diff --git a/components/treeview/data-binding/overview.md b/components/treeview/data-binding/overview.md index a24932ee63..cf3eba6100 100644 --- a/components/treeview/data-binding/overview.md +++ b/components/treeview/data-binding/overview.md @@ -57,7 +57,7 @@ The above model properties have the following meaning for the TreeView: | **Item relations** | | | `HasChildren` | Determines whether the item has children, no matter if they are loaded or not. Required for binding to **flat data** and for [**load on demand**]({%slug components/treeview/data-binding/load-on-demand%}). If `true`, the item will show an expand arrow. With **hierarchical data**, the TreeView renders expand icons based on `Items`, but `HasChildren` will take precedence. | | `ParentId` | Identifies the item's parent. Required for binding to **flat data**. Set to `null` for root items. **Do not use `ParentId` with hierarchical data.** | -| `Items` | Defines the item's children. Required for [binding to **hierarchical data**]({%slug components/treeview/data-binding/hierarchical-data%}). The children's type can be different from the parent item type. | +| `Items` | Defines the item's children. Required for [binding to **hierarchical data**]({%slug components/treeview/data-binding/hierarchical-data%}). The children's type can be different from the parent item type. The TreeView will render an expand arrow on the parent node if its child `Items` collection is not `null`. Also see `HasChildren`. | | [**Graphics**]({%slug treeview-icons%}) | | | `Icon` | Defines a [Telerik Font and Svg icon]({%slug common-features-icons%}) | | [**Navigation**]({%slug treeview-navigation%}) | | From b0ad6f319c12aa367bb4cc9cefa8d7d7e8c7f1ac Mon Sep 17 00:00:00 2001 From: Kendo Bot Date: Fri, 15 Nov 2024 17:02:30 +0200 Subject: [PATCH 006/392] Added new kb article grid-dynamically-adjusting-column-header-styles (#2523) * Added new kb article grid-dynamically-adjusting-column-header-styles * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Iva Stefanova Koevska-Atanasova * docs(Grid): Add example and update after review * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * Update knowledge-base/grid-dynamically-adjusting-column-header-styles.md Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> * docs(Grid): update KB example after review --------- Co-authored-by: KB Bot Co-authored-by: NansiYancheva <106161782+NansiYancheva@users.noreply.github.com> Co-authored-by: Iva Stefanova Koevska-Atanasova Co-authored-by: NansiYancheva Co-authored-by: Dimo Dimov <961014+dimodi@users.noreply.github.com> --- ...amically-adjusting-column-header-styles.md | 134 ++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100644 knowledge-base/grid-dynamically-adjusting-column-header-styles.md diff --git a/knowledge-base/grid-dynamically-adjusting-column-header-styles.md b/knowledge-base/grid-dynamically-adjusting-column-header-styles.md new file mode 100644 index 0000000000..5bafdc4c76 --- /dev/null +++ b/knowledge-base/grid-dynamically-adjusting-column-header-styles.md @@ -0,0 +1,134 @@ +--- +title: Adjust Grid Column Header Styles Dynamically +description: Learn how to dynamically change the style of a column header cell in a Telerik Blazor Grid based on condition. +type: how-to +page_title: How to Style Column Header Cells Dynamically in a Telerik Blazor Grid +slug: grid-dynamically-adjusting-column-header-styles +tags: grid, blazor, headerclass +res_type: kb +ticketid: 1670074 +--- + +## Environment + + + + + + + + +
ProductGrid for Blazor,
TreeList for Blazor
+ +## Description + +I am dynamically creating Grid columns in a loop and trying to adjust the column header cell style based on some condition and value from the [column field]({%slug components/grid/columns/bound%}#data-binding). Ideally, I want to implement logic to make this adjustment based on the value in the header cell. I have not been able to achieve this in the `HeaderTemplate` tag or in any of the cell render events handlers. In other templates, I have access to the `@context` field, which would make this easy, but that doesn't seem to work in the `HeaderTemplate`. + +## Solution + +To style a column header cell when dynamically creating columns in a loop, use the [`HeaderClass` parameter]({%slug components/grid/columns/bound%}#appearance) to set a CSS class under a condition and apply different styles depending on the class. For scenarios with numerous and more complex conditions, you can create a method to determine the appropriate class. + +Note that the [`HeaderTemplate`]({%slug grid-templates-column-header%}) does not receive a context argument because it is not related to rows and models, as outlined in the [Templates Overview]({%slug components/grid/features/templates%}) of the Telerik UI for Blazor documentation. + +### Example + +````CSHTML + + + + @for (int i = 0; i <= MaxYears; i++) + { + + } + + + + + + +@code { + private List GridData { get; set; } = new(); + private const int MaxYears = 10; + private const int StartYear = 2020; + private int currYear { get; set; } = DateTime.Now.Year; + + private string GetHeaderClass(int year) + { + if (year <= StartYear) + return "past-year-column"; + else if (year < currYear) + return "previous-year-column"; + else if (year == currYear) + return "current-year-column"; + else + return "future-year-column"; + } + + protected override void OnInitialized() + { + GridData = new List(); + + for (int i = 1; i <= 20; i++) + { + GridData.Add(new Product + { + Id = i, + Name = "Product name " + i, + StartYear0 = Random.Shared.Next(100, 9999), + StartYear1 = Random.Shared.Next(100, 9999), + StartYear2 = Random.Shared.Next(100, 9999), + StartYear3 = Random.Shared.Next(100, 9999), + StartYear4 = Random.Shared.Next(100, 9999), + StartYear5 = Random.Shared.Next(100, 9999), + StartYear6 = Random.Shared.Next(100, 9999), + StartYear7 = Random.Shared.Next(100, 9999), + StartYear8 = Random.Shared.Next(100, 9999), + StartYear9 = Random.Shared.Next(100, 9999), + StartYear10 = Random.Shared.Next(100, 9999) + }); + + } + + base.OnInitialized(); + } + + public class Product + { + public int Id { get; set; } + public string Name { get; set; } + public double? StartYear0 { get; set; } + public double? StartYear1 { get; set; } + public double? StartYear2 { get; set; } + public double? StartYear3 { get; set; } + public double? StartYear4 { get; set; } + public double? StartYear5 { get; set; } + public double? StartYear6 { get; set; } + public double? StartYear7 { get; set; } + public double? StartYear8 { get; set; } + public double? StartYear9 { get; set; } + public double? StartYear10 { get; set; } + } +} +``` + +## See Also + +- [Grid HeaderClass Parameter]({%slug components/grid/columns/bound%}#appearance) +- [Grid Column Header Template]({%slug grid-templates-column-header%}) +- [Templates Overview - Telerik UI for Blazor]({%slug components/grid/features/templates%}) From 3dbaa99c6d9f989f5eac863e14c28ac006510dae Mon Sep 17 00:00:00 2001 From: Kendo Bot Date: Mon, 18 Nov 2024 16:09:26 +0200 Subject: [PATCH 007/392] Added new kb article tooltip-position-rotated-div (#2526) * Added new kb article tooltip-position-rotated-div * chore(kb): update slug and examples * chore: apply recommendations --------- Co-authored-by: KB Bot Co-authored-by: Tsvetomir Hristov <106250052+Tsvetomir-Hr@users.noreply.github.com> --- .../tooltip-position-rotated-div.md | 138 ++++++++++++++++++ 1 file changed, 138 insertions(+) create mode 100644 knowledge-base/tooltip-position-rotated-div.md diff --git a/knowledge-base/tooltip-position-rotated-div.md b/knowledge-base/tooltip-position-rotated-div.md new file mode 100644 index 0000000000..480298229c --- /dev/null +++ b/knowledge-base/tooltip-position-rotated-div.md @@ -0,0 +1,138 @@ +--- +title: Adjusting Tooltip Position for Rotated Divs in Blazor +description: Learn how to adjust the position of the Telerik Blazor Tooltip when the target element is rotated, ensuring it displays correctly. +type: how-to +page_title: How to Correct Tooltip Position on Rotated Elements in Blazor +slug: tooltip-kb-position-rotated-div +tags: tooltip, blazor, css +res_type: kb +ticketid: 1657431 +--- + +## Environment + + + + + + + + +
Product + Grid for Blazor,
+ Tooltip for Blazor +
+ +## Description + +When rotating `
` elements that have an associated [Tooltip]({%slug tooltip-overview%}) to display additional information, the Tooltip might not align correctly with the target element. The goal is to adjust the Tooltip's position so it aligns appropriately with the center of the rotated `
`, and optionally, remove the Tooltip's callout pointer for a cleaner appearance. + +This KB article also answers the following questions: +- How to correctly position a Tooltip on a rotated `
` in Blazor? +- How can I hide the callout pointer of a Tooltip in Blazor? +- Is there a way to dynamically adjust Tooltip positioning based on element rotation in Blazor? + +## Solution + +To address the issue of Tooltip misalignment on rotated `
` elements, consider the following two approaches: + +### Use an Inner Tooltip Target + +Embed a tooltip target within the rotated element that won't be affected by the rotation. This method ensures the Tooltip aligns correctly without additional adjustments. + +````RAZOR + + +
+ Hover this rectangle ... + + + + + + + + ... or this one ... + + + + + + +
+ + +```` + +### Adjust Tooltip Margin Dynamically + +Calculate the necessary offset for the Tooltip and apply it as a margin style. Additionally, this solution includes how to hide the Tooltip's callout. + +````RAZOR + + +
+ Hover this rectangle ... + + + + +




+




+ + ... or this one ... + + + +
+ + + +@code { + private string TooltipMarginTop { get; set; } = string.Empty; + + private void OnTooltipTargetOver(string marginTop) + { + TooltipMarginTop = marginTop; + } +} +```` + +## See Also + +- [Telerik Blazor Tooltip - Overview]({%slug tooltip-overview%}) +- [Hide the Tooltip Callout or Change Its Position]({%slug tooltip-kb-callout-position%}) +- [Custom ToolTip Styles and Colors]({%slug tooltip-kb-custom-styles%}) From 549201804078bd2a75bf09d3537904a6ac4d3f75 Mon Sep 17 00:00:00 2001 From: Tsvetomir Hristov <106250052+Tsvetomir-Hr@users.noreply.github.com> Date: Mon, 18 Nov 2024 18:36:21 +0200 Subject: [PATCH 008/392] docs(common): replace ClearButton parameter (#2536) --- common-features/input-adornments.md | 14 +++++++------- common-features/input-validation.md | 6 +++--- components/autocomplete/filter.md | 2 +- components/autocomplete/overview.md | 4 ++-- components/combobox/appearance.md | 6 +++--- components/combobox/filter.md | 2 +- components/combobox/overview.md | 4 ++-- components/combobox/pre-select-item.md | 2 +- components/multicolumncombobox/appearance.md | 6 +++--- components/multicolumncombobox/overview.md | 2 +- components/multiselect/overview.md | 4 ++-- components/multiselect/pre-select-items.md | 2 +- components/multiselect/tag-mode.md | 6 +++--- knowledge-base/combobox-clear-button-click.md | 4 ++-- knowledge-base/combobox-not-closing.md | 4 ++-- knowledge-base/dropdown-kb-bind-to-enum.md | 2 +- knowledge-base/dropdowns-readonly-struct-error.md | 4 ++-- knowledge-base/inputs-align-text-right.md | 2 +- .../multiselect-always-select-item-limit-total.md | 4 ++-- styling-and-themes/override-theme-styles.md | 2 +- 20 files changed, 41 insertions(+), 41 deletions(-) diff --git a/common-features/input-adornments.md b/common-features/input-adornments.md index e937d94970..f7a5e80a2f 100644 --- a/common-features/input-adornments.md +++ b/common-features/input-adornments.md @@ -99,7 +99,7 @@ To add a prefix, declare a `<*ComponentName*PrefixTemplate>` tag as a direct chi @@ -113,7 +113,7 @@ To add a prefix, declare a `<*ComponentName*PrefixTemplate>` tag as a direct chi @@ -146,7 +146,7 @@ To add a prefix, declare a `<*ComponentName*PrefixTemplate>` tag as a direct chi @@ -243,7 +243,7 @@ To add a suffix, declare a `<*ComponentName*SuffixTemplate>` tag as a direct chi @@ -257,7 +257,7 @@ To add a suffix, declare a `<*ComponentName*SuffixTemplate>` tag as a direct chi @@ -290,7 +290,7 @@ To add a suffix, declare a `<*ComponentName*SuffixTemplate>` tag as a direct chi @@ -372,7 +372,7 @@ To prevent that behavior, you may wrap the content of the prefix/suffix template + ShowClearButton="true">
+ Placeholder="Enter your role (can be free text)" ShowClearButton="true" />

@@ -243,7 +243,7 @@ The ComboBox works with the `Value` of the selected item (through its `ValueFiel

- @@ -301,7 +301,7 @@ The ComboBox works with the `Value` of the selected item (through its `ValueFiel

- +

diff --git a/components/autocomplete/filter.md b/components/autocomplete/filter.md index bbe3ff22e2..05d5ef8a27 100644 --- a/components/autocomplete/filter.md +++ b/components/autocomplete/filter.md @@ -67,7 +67,7 @@ By default, the filtering is debounced with 150ms. Configure that with the [`Deb MinLength="@FilterMinLength" DebounceDelay="@AutoCompleteDebounceDelay" Placeholder="Type 's' or 'a' to see the difference" - ClearButton="true" + ShowClearButton="true" Width="300px" /> @code{ diff --git a/components/autocomplete/overview.md b/components/autocomplete/overview.md index 348c901133..20da228f63 100644 --- a/components/autocomplete/overview.md +++ b/components/autocomplete/overview.md @@ -29,7 +29,7 @@ User input: @AutoCompleteValue + ShowClearButton="true" /> @code{ //Current value is null (no item is selected) which allows the Placeholder to be displayed. @@ -94,7 +94,7 @@ The Blazor AutoComplete provides various parameters that allow you to configure | `Value` and `bind-Value` | `string` | Get/set the value of the component, can be used for binding. Use the `@bind-Value` syntax for two-way binding, for example, to a variable of your own. The `Value` must be a `string`.| | `ValueField` | `string`
(`Value`) | The name of the field from the model that will be shown as hints to the user. Not required when binding to a simple list of strings. | | `TabIndex` | `int?` | Maps to the `tabindex` attribute of the HTML element. You can use it to customize the order in which the inputs in your form focus with the `Tab` key. | -| `ClearButton` | `bool` | Whether the user will have the option to clear the selected value with a button on the input. When it is clicked, the `Value` will be updated to `string.Empty`. | +| `ShowClearButton` | `bool` | Whether the user will have the option to clear the selected value with a button on the input. When it is clicked, the `Value` will be updated to `string.Empty`. | | `Enabled` | `bool` | Use this Boolean property to render a disabled Blazor AutoComplete component until certain requirements are met. | | `ReadOnly` | `bool` | If set to `true`, the component will be readonly and will not allow user input. The component is not readonly by default and allows user input. | | `MinLength` | `int` | How many characters the text has to be before the suggestions list appears. Cannot be `0`. Often works together with [filtering]({%slug autocomplete-filter%}). | diff --git a/components/combobox/appearance.md b/components/combobox/appearance.md index 34dc7dd6bc..a295c6c4be 100644 --- a/components/combobox/appearance.md +++ b/components/combobox/appearance.md @@ -47,7 +47,7 @@ You can increase or decrease the size of the ComboBox by setting the `Size` attr ValueField="MyValueField" @bind-Value="selectedValue" Placeholder="Select an item..." - ClearButton="true" + ShowClearButton="true" Filterable="true">
@@ -105,7 +105,7 @@ The `Rounded` attribute applies the `border-radius` CSS rule to the ComboBox to ValueField="MyValueField" @bind-Value="selectedValue" Placeholder="Select an item..." - ClearButton="true" + ShowClearButton="true" Filterable="true">
@@ -162,7 +162,7 @@ The `FillMode` controls how the TelerikComboBox is filled. You can set it to a m ValueField="MyValueField" @bind-Value="selectedValue" Placeholder="Select an item..." - ClearButton="true" + ShowClearButton="true" Filterable="true">
diff --git a/components/combobox/filter.md b/components/combobox/filter.md index 87c86fbb33..ecec3e64d0 100644 --- a/components/combobox/filter.md +++ b/components/combobox/filter.md @@ -60,7 +60,7 @@ By default, the filtering is debounced with 150ms. Configure that with the [`Deb FilterOperator="@FilterOperator" DebounceDelay="@DebounceDelay" Placeholder="Type digits to see filtering in action" - ClearButton="true" + ShowClearButton="true" Width="300px"> diff --git a/components/combobox/overview.md b/components/combobox/overview.md index 41182a0817..c65d01838f 100644 --- a/components/combobox/overview.md +++ b/components/combobox/overview.md @@ -27,7 +27,7 @@ Selected value: @selectedValue
+ Placeholder="Select an item..." ShowClearButton="true" Filterable="true"> @code { @@ -85,7 +85,7 @@ The Blazor ComboBox @[template](/_contentTemplates/dropdowns/features.md#groupin | ----------- | ----------- | -----------| | `AdaptiveMode` | `AdaptiveMode`
(`None`) | The [adaptive mode]({%slug adaptive-rendering%}) of the component. | | `AllowCustom` | `bool` | whether the user can enter [custom values]({%slug components/combobox/custom-value%}). If enabled, the `ValueField` must be a `string`. | -| `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`. | +| `ShowClearButton` | `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`. | | `Data` | `IEnumerable` | allows you to provide the data source. Required. | | `DebounceDelay` | `int`
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. | | `Enabled` | `bool` | whether the component is enabled. | diff --git a/components/combobox/pre-select-item.md b/components/combobox/pre-select-item.md index 3c2a79ce3e..5d880fad54 100644 --- a/components/combobox/pre-select-item.md +++ b/components/combobox/pre-select-item.md @@ -22,7 +22,7 @@ Selected value: @selectedValue
+ Placeholder="Select an item..." ShowClearButton="true" Filterable="true"> @code { diff --git a/components/multicolumncombobox/appearance.md b/components/multicolumncombobox/appearance.md index af45b373f2..b1b7922ff8 100644 --- a/components/multicolumncombobox/appearance.md +++ b/components/multicolumncombobox/appearance.md @@ -47,7 +47,7 @@ You can increase or decrease the size of the MultiColumnComboBox by setting the ValueField="MyValueField" @bind-Value="selectedValue" Placeholder="Select an item..." - ClearButton="true" + ShowClearButton="true" Filterable="true"> @@ -109,7 +109,7 @@ The `Rounded` attribute applies the `border-radius` CSS rule to the MultiColumnC ValueField="MyValueField" @bind-Value="selectedValue" Placeholder="Select an item..." - ClearButton="true" + ShowClearButton="true" Filterable="true"> @@ -170,7 +170,7 @@ The `FillMode` controls how the TelerikMultiColumnComboBox is filled. You can se ValueField="MyValueField" @bind-Value="selectedValue" Placeholder="Select an item..." - ClearButton="true" + ShowClearButton="true" Filterable="true"> diff --git a/components/multicolumncombobox/overview.md b/components/multicolumncombobox/overview.md index 138beb1f29..2bf8564018 100644 --- a/components/multicolumncombobox/overview.md +++ b/components/multicolumncombobox/overview.md @@ -111,7 +111,7 @@ The MultiColumnComboBox @[template](/_contentTemplates/dropdowns/features.md#gro | ----------- | ----------- | -----------| | `AdaptiveMode` | `AdaptiveMode`
(`None`) | The [adaptive mode]({%slug adaptive-rendering%}) of the component. | | `AllowCustom` | `bool` | Determines if the user can enter [custom values]({%slug multicolumncombobox-custom-value%}). If enabled, the `ValueField` must be a `string`. | -| `ClearButton` | `bool` | Displays a clear button inside the input. When it is clicked, the `Value` will change to `default(TValue)`, so there must be no item in the `Data` that has such a `Value`. For example, if `TValue` is `int`, there should be no data item with `0` in its `ValueField`, otherwise selection issues may occur. | +| `ShowClearButton` | `bool` | Displays a clear button inside the input. When it is clicked, the `Value` will change to `default(TValue)`, so there must be no item in the `Data` that has such a `Value`. For example, if `TValue` is `int`, there should be no data item with `0` in its `ValueField`, otherwise selection issues may occur. | | `Data` | `IEnumerable` | The component data. | | `DebounceDelay` | `int`
(`150`) | The 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. | | `Enabled` | `bool` | Whether the user can interact with the component. | diff --git a/components/multiselect/overview.md b/components/multiselect/overview.md index 8a31bca97d..149c74caa3 100644 --- a/components/multiselect/overview.md +++ b/components/multiselect/overview.md @@ -29,7 +29,7 @@ The Blaz + Width="350px" ShowClearButton="true" AutoClose="false"> @if (Values.Count > 0) { @@ -99,7 +99,7 @@ The Blazor MultiSelect provides various parameters that allow you to configure t | ----------- | ----------- | ------ | | `AdaptiveMode` | `AdaptiveMode`
(`None`) | The [adaptive mode]({%slug adaptive-rendering%}) of the component. | | `AutoClose` | `bool`
(`true`) | Defines whether the dropdown list containing the items for the MultiSelect will automatically close after each user selection. | -| `ClearButton` | `bool` | Whether the user will have the option to clear the selected items with a button on the input. When it is clicked, the `Value` will be updated to an empty list. | +| `ShowClearButton` | `bool` | Whether the user will have the option to clear the selected items with a button on the input. When it is clicked, the `Value` will be updated to an empty list. | | `Data` | `IEnumerable` | Allows you to provide the data source. Required. | | `DebounceDelay` | `int`
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. | | `Enabled` | `bool` | Whether the component is enabled. | diff --git a/components/multiselect/pre-select-items.md b/components/multiselect/pre-select-items.md index 00ac425481..a42a96655c 100644 --- a/components/multiselect/pre-select-items.md +++ b/components/multiselect/pre-select-items.md @@ -32,7 +32,7 @@ and Value="@SelectedProductIDs" ValueField="@nameof(Product.Id)" TextField="@nameof(Product.Name)" - ClearButton="true" + ShowClearButton="true" Placeholder="Select Products"> diff --git a/components/multiselect/tag-mode.md b/components/multiselect/tag-mode.md index ae05caddaa..733b8b02cd 100644 --- a/components/multiselect/tag-mode.md +++ b/components/multiselect/tag-mode.md @@ -34,7 +34,7 @@ To use the single tag mode, set the `TagMode` parameter to `MultiSelectTagMode.S TagMode="@MultiSelectTagMode.Single" Placeholder="Enter Balkan country, e.g., Bulgaria" Width="350px" - ClearButton="true" + ShowClearButton="true" AutoClose="false"> @@ -73,7 +73,7 @@ When the multiple tag mode is enabled, each selected item will be displayed as a TagMode="@MultiSelectTagMode.Multiple" Placeholder="Enter Balkan country, e.g., Bulgaria" Width="350px" - ClearButton="true" + ShowClearButton="true" AutoClose="false"> @@ -113,7 +113,7 @@ To restrict the allowed number of individual tags, use the `MaxAllowedTags` para MaxAllowedTags="2" Placeholder="Enter Balkan country, e.g., Bulgaria" Width="350px" - ClearButton="true" + ShowClearButton="true" AutoClose="false"> diff --git a/knowledge-base/combobox-clear-button-click.md b/knowledge-base/combobox-clear-button-click.md index 0078191cb8..5972dce27d 100644 --- a/knowledge-base/combobox-clear-button-click.md +++ b/knowledge-base/combobox-clear-button-click.md @@ -36,7 +36,7 @@ What you need to do is to check if the new value that comes in is the `default` ````CSHTML Monitor the console to see when the events fire in these examples. You can use only one of the events, this sample showcases both so you can see the options. - @@ -63,7 +63,7 @@ Monitor the console to see when the events fire in these examples. You can use o
- diff --git a/knowledge-base/combobox-not-closing.md b/knowledge-base/combobox-not-closing.md index 666848d9da..ccc1ca797f 100644 --- a/knowledge-base/combobox-not-closing.md +++ b/knowledge-base/combobox-not-closing.md @@ -39,7 +39,7 @@ Selected value: @selectedValue
+ Placeholder="Select an item..." ShowClearButton="true" > @code { @@ -75,7 +75,7 @@ Selected value: @selectedValue
+ Placeholder="Select an item..." ShowClearButton="true" > @code { diff --git a/knowledge-base/dropdown-kb-bind-to-enum.md b/knowledge-base/dropdown-kb-bind-to-enum.md index fb5946ecc2..e9f6989081 100644 --- a/knowledge-base/dropdown-kb-bind-to-enum.md +++ b/knowledge-base/dropdown-kb-bind-to-enum.md @@ -40,7 +40,7 @@ Here are examples of both. @* for a combo box, make sure that custom values and clearing are not available unless you are explicitly OK with that *@ - + @code{ string CurrValue { get; set; } diff --git a/knowledge-base/dropdowns-readonly-struct-error.md b/knowledge-base/dropdowns-readonly-struct-error.md index b197b39bc5..8051c484df 100644 --- a/knowledge-base/dropdowns-readonly-struct-error.md +++ b/knowledge-base/dropdowns-readonly-struct-error.md @@ -39,7 +39,7 @@ Selected value: @selectedValue
+ Placeholder="Select an item..." ShowClearButton="true" Filterable="true"> @code { @@ -77,6 +77,6 @@ There are two approaches to avoiding this error: + Placeholder="Select an item..." ShowClearButton="true" Filterable="false"> diff --git a/knowledge-base/inputs-align-text-right.md b/knowledge-base/inputs-align-text-right.md index 9eb128dbfb..0f98a97e01 100644 --- a/knowledge-base/inputs-align-text-right.md +++ b/knowledge-base/inputs-align-text-right.md @@ -63,7 +63,7 @@ The example below shows how to align a numeric textbox and a combo box to the ri

ComboBox - Right alignment

+ Placeholder="Select an item..." ShowClearButton="true" Filterable="true" Class="myCombobox"> diff --git a/knowledge-base/multiselect-always-select-item-limit-total.md b/knowledge-base/multiselect-always-select-item-limit-total.md index 0359c753ba..214ed44a4e 100644 --- a/knowledge-base/multiselect-always-select-item-limit-total.md +++ b/knowledge-base/multiselect-always-select-item-limit-total.md @@ -50,7 +50,7 @@ You can find two examples below that showcase doing this: + ShowClearButton="false">