Merge pull request #1053 from telerik/master

Merge master into development

_config.yml

@@ -27,6 +27,9 @@ navigation:
     controls:
         title: "Controls"
         position: 4
+    styling-and-themes:
+        title: "Styling and Themes"
+        position: 5
     security:
         title: "Security"
         position: 7
@@ -328,7 +331,7 @@ navigation:
     ## End ListPicker
     ## ListView
     controls/listview:
-        title: "ListView"
+        title: "ListView (Obsolete)"
         ## ListView Sub-Folders
     controls/listview/grouping:
         title: "Grouping"
@@ -643,7 +646,6 @@ intro_columns:
       "DataForm": "dataform-overview"
       "DataGrid": "datagrid-overview"
       "DataPager": "datapager-overview"
-      "ListView": "listview-overview"
       "ItemsControl": "itemscontrol-overview"
   -
     title: "Data Visualization"
@@ -726,11 +728,11 @@ intro_columns:
   -
     title: "Document Processing Libraries"
     items:
-        "PdfProcessing": "pdfprocessing-overview"
-        "WordsProcessing": "wordsprocessing-overview"
-        "SpreadProcessing": "spreadprocessing-overview"
-        "SpreadStreamProcessing": "spreadstreamprocessing-overview"
-        "ZipLibrary": "ziplibrary-overview"
+        "PdfProcessing": "document-processing-libraries-overview"
+        "WordsProcessing": "document-processing-libraries-overview"
+        "SpreadProcessing": "document-processing-libraries-overview"
+        "SpreadStreamProcessing": "document-processing-libraries-overview"
+        "ZipLibrary": "document-processing-libraries-overview"
 
 # Assets pipeline configuration
 assets:

_contentTemplates/common/listview-obsolete.md

@@ -0,0 +1,3 @@
+#listview-obsolete
+>caution The `RadListView` control is now obsolete and will be removed in the future. Use the [RadCollectionView]({%slug collectionview-overview%}) control instead. The `RadCollectionView` is a complete, ground-up rewrite of the ListView. The `RadCollectionView` offers improved performance, enhanced features, and a modernized approach to managing lists of data. The `RadCollectionView` incorporates all of the ListView's key features. More about the differences between both components and how to migrate to the new `RadCollectionView` is available in the [Migrating the Telerik .NET MAUI RadListView to RadCollectionView]({%slug listview-migration%}) article.
+#end

_contentTemplates/common/manual-packages.md

@@ -0,0 +1,6 @@
+#manual-packages-location
+You can get the Telerik UI for .NET MAUI assemblies in two ways:
+
+* After installing the controls by [using the MSI installer]({%slug automated-installer%})—By default, once you complete the installation, the assemblies will be located in the `C:\Program Files\Progress\Binaries` (for 32-bit machines) or `C:\Program Files (x86)\Progress\Binaries` (for 64-bit machines) folder.
+* By downloading the [ZIP archive]({%slug zip-archive%}) with the controls—Look for the `Binaries` folder in the archive.
+#end

_contentTemplates/common/net-version.md

@@ -1,3 +1,3 @@
 #net-version
-> The `Telerik.UI.for.Maui` and `Telerik.UI.for.Maui.Trial` NuGet packages support `.NET 8.0`, and `.NET 9 Preview 6` or later projects. These packages automatically restore the required package dependencies based on the .NET version that your project uses.
+> The `Telerik.UI.for.Maui` and `Telerik.UI.for.Maui.Trial` NuGet packages support `.NET 8.0`, and `.NET 9`. These packages automatically restore the required package dependencies based on the .NET version that your project uses.
 #end

_contentTemplates/get-started.md

@@ -14,11 +14,11 @@
 #add-namespace-register-controls
 To use the controls in the Telerik UI for .NET MAUI library, add the Telerik namespace:
 
-1. In the `MainPage.xaml` file, locate the root element at the top. with the already available namespaces.
+1. In the `MainPage.xaml` file, locate the root element at the top.
 1. Paste the Telerik namespace below the last already available namespace:
 
 	```
-	xmlns:telerikCombo="telerik="http://schemas.telerik.com/2022/xaml/maui"
+	xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
 	```
 
 To visualize the Telerik controls, register them in the `MauiProgram.cs` file of your project:
@@ -40,7 +40,7 @@ To visualize the Telerik controls, register them in the `MauiProgram.cs` file of
 #end
 
 #add-telerik-component
-In this step, you will replace the Button control in Microsoft's template with a Telerik control. The Telerik UI for .NET MAUI [TemplatedButton](https://docs.telerik.com/devtools/maui/controls/templatedbutton/overview) that you will use gives you full control over the Button's content.
+In this step, you will replace the Button control in Microsoft's project template with a Telerik control. The Telerik UI for .NET MAUI [TemplatedButton](https://docs.telerik.com/devtools/maui/controls/templatedbutton/overview) that you will use gives you full control over the Button's content.
 
 To add the TemplatedButton control to the application:
 
@@ -129,5 +129,5 @@ In this step, you will edit the code-behind file by adding logic that makes the
 	</telerik:RadTemplatedButton>
 	```
 
-To run the application, press `F5`. Congratulations, you added created your first app with Telerik UI for .NET MAUI controls!
-#end
+To run the application, press `F5`. Congratulations, you created your first app with Telerik UI for .NET MAUI controls!
+#end

controls/autocomplete/commands.md

@@ -8,23 +8,23 @@ slug: autocomplete-commands
 
 # .NET MAUI AutoComplete Commands
 
-The .NET MAUI AutoComplete provides a `RemoveTokenCommand` that lets you manipulate its [tokens selection]({%slug autocomplete-tokens-support%}).
+The .NET MAUI AutoComplete provides a `RemoveTokenCommand` that lets you manipulate its [token selection]({%slug autocomplete-tokens-support%}) and a `ClearTextCommand` that lets you clear the entered text/selected tokens.
 
 ## Remove Token Command
 
 `RemoveTokenCommand`(`ICommand`)—Removes a token from the AutoComplete selection in the `Tokens` display mode. This command is called from the token's `DataTemplate` when the user taps the close button to remove the token.
 
 >Go to [Tokens Support in .NET MAUI AutoComplete]({%slug autocomplete-tokens-support%}) for detailed information on the `Tokens` display mode.
 
-## Example with the Default RemoveTokenCommand
+### Example with the Default RemoveTokenCommand
 
 The example below shows how to call the default `RemoveTokenCommand` from a custom `TokenTemplate` implementation:
 
 <snippet id='autocomplete-default-removetoken' />
 
 ![Telerik .NET MAUI AutoComplete default RemoveTokenCommand](images/autocomplete-removetokencommand-template.png)
 
-## Example with a Custom RemoveTokenCommand
+### Example with a Custom RemoveTokenCommand
 
 The next example demonstrates a custom `RemoveTokenCommand` implementation&mdash;a confirmation dialog appears before the default command is executed.
 
@@ -38,6 +38,42 @@ The next example demonstrates a custom `RemoveTokenCommand` implementation&mdash
 
 ![Telerik .NET MAUI AutoComplete custom RemoveTokenCommand](images/autocomplete-removetoken.gif)
 
+## Clear Text Command
+
+`ClearTextCommand`(`ICommand`)&mdash;Sets the AutoComplete text to `null`.This command is called when the user taps the clear button and clears the entered text as well as any tokens.
+
+The example below demonstrates a custom `ClearTextCommand` implementation&mdash;a confirmation dialog appears before the default command is executed.
+
+**1.** Create a custom command class that inherits from `AutoCompleteClearTextCommand`. Override, for example, its `Execute` method:
+
+```C#
+public class CustomAutoCompleClearTextCommand : AutoCompleteClearTextCommand
+{
+    public override async void Execute(object parameter)
+    {
+        bool executeDefault = await App.Current.MainPage.DisplayAlert("Confirm", "Clear text?", "Yes", "No");
+        if (executeDefault)
+        {
+            base.Execute(parameter);
+        }
+    }
+}
+```
+
+**2.** Apply the newly created command class to the `ClearTextCommand` of the AutoComplete:
+
+```XAML
+<telerik:RadAutoComplete ItemsSource="{Binding Source}"
+                         TextSearchPath="Name"
+                         DisplayMode="Tokens">
+    <telerik:RadAutoComplete.ClearTextCommand>
+        <local:CustomAutoCompleClearTextCommand />
+    </telerik:RadAutoComplete.ClearTextCommand>
+</telerik:RadAutoComplete>
+```
+
+![Telerik .NET MAUI AutoComplete custom ClearTextCommand](images/autocomplete-cleartext.gif)
+
 ## See Also
 
 - [Tokens Support]({%slug autocomplete-tokens-support%})

controls/autocomplete/styling.md

@@ -15,7 +15,6 @@ The Telerik UI for .NET MAUI AutoComplete control provides the following Style p
 * `Font Options`(`FontAttributes`, `FontFamily`, `FontSize`)—Defines the font options for the text of the AutoComplete.
 * `BorderBrush`(`Brush`)—Defines the brush of the border around the control.
 * `BorderThickness`(`Thickness`)—Defines the thickness of the border around the control.
-* `FocusedBorderBrush`(`Brush`)—Defines the color of the border when the control is focused.
 * `ClearButtonStyle` (of type `Style` with target type `Telerik.Maui.Controls.RadTemplatedButton`)—Defines the style for the clear button.
 * `TextInputStyle`(of type `Style` with target type `Telerik.Maui.Controls.RadTextInput`)—Defines the style of the inner `RadTextInput` control.
 
@@ -42,7 +41,7 @@ The example below demonstrates some of the styling capabilities of the AutoCompl
 
 **1.** Add a Style that targets the `RadAutoComplete` to your page's resources and apply all the needed styling properties and the visual states:
 
-<snippet id=' autocomplete-custom-styles' />
+<snippet id='autocomplete-custom-styles' />
 
 **2.** Define the AutoComplete in XAML:
 

controls/badgeview/badge-overview.md

@@ -29,7 +29,7 @@ The Badge indicator provides the following properties:
 * `BorderColor`(`Microsoft.Maui.Graphics.Color`)—Defines the Badge border color.
 * `CornerRadius`(`Microsoft.Maui.Thickness`)—Defines the corner radius of the Badge border.
 * `BorderThickness`(`Microsoft.Maui.Thickness`)—Defines the Badge border thickness.
-* `AnimationType`(`Telerik.Maui.Controls.Compatibility.Primitives.BadgeAnimationType`)—You can choose between `Scale` and `None`. The default value is `Scale`.
+* `AnimationType`(`Telerik.Maui.Controls.BadgeView.BadgeAnimationType`)—You can choose between `Scale` and `None`. The default value is `Scale`.
 * `AnimationEasing`(`Microsoft.Maui.Easing`)—Defines the animation easing. For more details about different easing options, refer to the article on [`Microsoft.Maui.Easing`](https://docs.microsoft.com/en-us/dotnet/maui/user-interface/animation/easing). The default value is `SinInOut`.
 * `AnimationDuration` in milliseconds(`int`)—Defines the animation duration in milliseconds. The default value is 300.
 * `ControlTemplate`(`Microsoft.Maui.Controls.ControlTemplate`)—Specifies the Badge control template.

controls/badgeview/xamarin-migration.md

@@ -20,7 +20,7 @@ When migrating the BadgeView from Xamarin to .NET MAUI, consider the following d
 | Control | Control name | XAML Namespace | C# Namespace|
 | --------------- | --------------- | --------------- | --------------- |
 | Xamarin BadgeView | `RadBadgeView` | xmlns:telerikPrimitives="clr-namespace:Telerik.XamarinForms.Primitives;assembly=Telerik.XamarinForms.Primitives" | using Telerik.XamarinForms.Primitives; |
-| .NET MAUI BadgeView | `RadBadgeView` | xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui" | using Telerik.Maui.Controls.Compatibility.Primitives; |
+| .NET MAUI BadgeView | `RadBadgeView` | xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui" | using Telerik.Maui.Controls; |
 
 ## See Also
 

controls/barcode/xamarin-migration.md

@@ -20,7 +20,7 @@ When migrating the Barcode from Xamarin to .NET MAUI, consider the following dif
 | Control | Control name | XAML Namespace | C# Namespace|
 | --------------- | --------------- | --------------- | --------------- |
 | Xamarin Barcode | `RadBarcode` | xmlns:telerikBarcode="clr-namespace:Telerik.XamarinForms.Barcode;assembly=Telerik.XamarinForms.Barcode" | using Telerik.XamarinForms.Barcode; |
-| .NET MAUI Barcode | `RadBarcode` | xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui" | using Telerik.Maui.Controls.Compatibility.Barcode; |
+| .NET MAUI Barcode | `RadBarcode` | xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui" | using Telerik.Maui.Controls; |
 
 ## See Also
 

controls/chart/xamarin-migration.md

@@ -19,8 +19,8 @@ When migrating the Chart from Xamarin to .NET MAUI, consider the following diffe
 
 | Control | Control name | XAML Namespace | C# Namespace|
 | --------------- | --------------- | --------------- | --------------- |
-| Xamarin Chart | `RadChart` | xmlns:telerikChart="clr-namespace:Telerik.XamarinForms.Chart;assembly=Telerik.XamarinForms.Chart" | using Telerik.XamarinForms.Chart; |
-| .NET MAUI Chart | `RadChart` | xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui" | using Telerik.Maui.Controls.Compatibility.Chart; |
+| Xamarin Chart | `RadCartesianChart`/`RadPieChart` | xmlns:telerikChart="clr-namespace:Telerik.XamarinForms.Chart;assembly=Telerik.XamarinForms.Chart" | using Telerik.XamarinForms.Chart; |
+| .NET MAUI Chart | `RadCartesianChart`/`RadPieChart` | xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui" | using Telerik.Maui.Controls.Compatibility.Chart; |
 
 ## See Also
 

controls/collectionview/grouping/header.md

@@ -22,8 +22,8 @@ The `BindingContext` of the `GroupHeader` is a complex object—`GroupContex
 
 The CollectionView control for .NET MAUI provides the following styling properties for customizing the appearance of the group view:
 
-* `GroupViewStyle`(`Style` with target type `RadCollectionViewGroupItem`)—Specifies the style applied to the group view.
-* `GroupViewStyleSelector`(`Style` with target type `RadCollectionViewGroupItem`)—Specifies the style selector for the group view.
+* `GroupViewStyle`(`Style` with target type `RadCollectionViewGroupView`)—Specifies the style applied to the group view.
+* `GroupViewStyleSelector`(`Style` with target type `RadCollectionViewGroupView`)—Specifies the style selector for the group view.
 
 ## Customizing the Area With the Group Header Text
 

controls/collectionview/grouping/overview.md

@@ -32,7 +32,7 @@ Users can control the `GroupDescriptors` collection by using MVVM.
 
 Style the group header by setting the following properties:
 
-* `GroupContainerStyle` (`Style` with target type `RadCollectionViewGroupItem`)—Specifies the style applied to the group header when grouping is applied.
+* `GroupContainerStyle` (`Style` with target type `RadCollectionViewGroupView`)—Specifies the style applied to the group header when grouping is applied.
 
 ## See Also
 

controls/collectionview/styling/group-style-selector.md

@@ -12,7 +12,7 @@ The .NET MAUI CollectionView component exposes a conditional styling feature tha
 
 Apply conditional styling to the group header by setting the following properties:
 
-* `GroupViewStyleSelector` (`Style` with target type `RadCollectionViewGroupItem`)—Specifies the style applied to the group container when grouping is applied.
+* `GroupViewStyleSelector` (`Style` with target type `RadCollectionViewGroupView`)—Specifies the style applied to the group container when grouping is applied.
 
 The following example shows how to use the `GroupViewStyleSelector`:
 

controls/collectionview/styling/group-style.md

@@ -11,7 +11,7 @@ tags: style, group, collectionview, maui, dotnet maui
 
 To style the group header set the following properties:
 
-* `GroupViewStyle` (`Style` with target type `RadCollectionViewGroupItem`)—Specifies the style applied to the group header when grouping is applied.
+* `GroupViewStyle` (`Style` with target type `RadCollectionViewGroupView`)—Specifies the style applied to the group header when grouping is applied.
 
 The `GroupViewStyle` has a `ExpandCollapseIndicatorStyle` property that allows you to style the expand indicator. The `ExpandCollapseIndicatorStyle` (`Style` with target type `Label`).
 

controls/combobox/editmode-and-search.md

@@ -24,7 +24,7 @@ This topic describes in details the configuration options related to the editabl
 ComboBox provides both case-sensitive and case-insensitive searching modes. The following properties are exposed:
 
 - `SearchMode`(enumeration of type `Telerik.Maui.Controls.SearchMode`)—Defines the value that sets search sets some search criteria for the control. The available options are: `Contains`, `StartsWith`, `ContainsCaseSensitive` and `StartsWithCaseSensitive`. The default SearchMode is `StartsWith`.
-- `SearchTexhPath`(`string`)—Specifies the name of the property against which the searching will be performed.
+- `SearchTextPath`(`string`)—Specifies the name of the property against which the searching will be performed.
 * `HighlightTextColor`(*Microsoft.Maui.Graphics.Color*)—Defines the color of the text that will be highlighted when searching is performed.
 
 > Searching can be performed when `IsEditable` is `true`.

controls/combobox/filtering.md

@@ -8,7 +8,7 @@ slug: combobox-filtering
 
 # .NET MAUI ComboBox Filtering
 
-The [Telerik UI for .NET MAUI ComboBox]({%slug combobox-overview%}) provides filtering, which allows the users to refine their search results as they type into the input field. The default filtering is performed according to the `SearchMode` and `SearchTexhPath` properties of the ComboBox. 
+The [Telerik UI for .NET MAUI ComboBox]({%slug combobox-overview%}) provides filtering, which allows the users to refine their search results as they type into the input field. The default filtering is performed according to the `SearchMode` and `SearchTextPath` properties of the ComboBox. 
 
 For more details on the search functionality of the ComboBox, go to the [Edit Mode & Search]({%slug combobox-editmode-and-search%}) topic.
 

controls/datagrid/columns/nested-properties.md

@@ -31,7 +31,7 @@ Here is an example of how you can use the nested properties feature in DataGrid:
 **3.** In the sample, both classes inherit from the `NotifyPropertyChangedBase` class, which implements the `INotifyPropertyChanged` interface. You would need to add the following namespace to use it:
 
 ```C#
-using Telerik.Maui.Controls.Compatibility.Common;
+using Telerik.Maui.Controls;
 ```
 
 **4.** Create a ViewModel with a collection of `Person` objects:

controls/datagrid/events.md

@@ -31,7 +31,7 @@ The following example demonstrates how to use the `LoadOnDemand` event.
 
 ## Loading Distinct Values
 
-The DataGrid enables you to load the distinct values that will be displayed in the `Telerik.Maui.Controls.Compatibility.DataGrid.DataGridDistinctValuesFilterView` through the `DistinctValuesLoading` event. The `DistinctValuesLoading` event handler receives the following parameters:
+The DataGrid enables you to load the distinct values that will be displayed in the `Telerik.Maui.Controls.DataGrid.DataGridDistinctValuesFilterView` through the `DistinctValuesLoading` event. The `DistinctValuesLoading` event handler receives the following parameters:
 
 * The `sender` argument, which is of type `object`, but can be cast to the `RadDataGrid` type.
 * A `DistinctValuesLoadingEventArgs` object, which provides the following properties:

controls/datagrid/filtering/programmatic-filtering.md

@@ -33,7 +33,7 @@ All `FilterDescriptors` are located in the `Telerik.Maui.Controls.Data` namespac
 When using C#, you'll need to add the using statement
 
 ```C#
-using Telerik.Maui.Controls.Compatibility.Common.Data;
+using Telerik.Maui.Controls.Data;
 ```
 
 Alternatively, if using XAML, they're be resolved through the same `telerik` xmlns:
@@ -196,7 +196,7 @@ The following example demonstrates the `CustomFilter` implementation:
 
 <!-- <snippet id='datagrid-delegatefilterdescriptor-csharp'/> -->
 ```C#
-class CustomFilter : Telerik.Maui.Controls.Compatibility.Common.Data.IFilter
+class CustomFilter : Telerik.Maui.Controls.Data.IFilter
 {
     public bool PassesFilter(object item)
     {
@@ -214,7 +214,7 @@ class CustomFilter : Telerik.Maui.Controls.Compatibility.Common.Data.IFilter
 }
 ```
 
-> `IFilter` is in `Telerik.Maui.Controls.Compatibility.Common.Data` namespace.
+> `IFilter` is in `Telerik.Maui.Controls.Data` namespace.
 
 Add the `DelegateFilterDescriptor` to the `RadDataGrid` instance:
 
@@ -223,4 +223,4 @@ Add the `DelegateFilterDescriptor` to the `RadDataGrid` instance:
 dataGrid.FilterDescriptors.Add(new DelegateFilterDescriptor() { Filter = new CustomFilter()});
 ```
 
->important For a runnable example with the DataGrid Programmatic Filtering scenario, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to DataGrid > Filtering > Programmatic Filtering.
+>important For a runnable example with the DataGrid Programmatic Filtering scenario, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to **DataGrid > Filtering > Programmatic Filtering**.