Skip to content

Commit c24d449

Browse files
Merge pull request #1092 from telerik/master
merge master into dev
2 parents 67ac94f + f9845cf commit c24d449

File tree

185 files changed

+2378
-337
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

185 files changed

+2378
-337
lines changed

_pdf.yml

Lines changed: 66 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -5,73 +5,96 @@ intro_columns:
55
-
66
categories:
77
-
8-
title: "Data Controls"
8+
title: "Data Controls"
99
items:
10+
"CollectionView": "collectionview-overview"
11+
"DataForm": "dataform-overview"
1012
"DataGrid": "datagrid-overview"
11-
"ListView": "listview-overview"
12-
"DataForm": "dataform-overview"
13+
"DataPager": "datapager-overview"
14+
"ItemsControl": "itemscontrol-overview"
1315
-
14-
title: "Pdf Viewer"
16+
title: "Data Visualization"
1517
items:
16-
"PdfViewer": "pdfviewer-overview"
18+
"Barcodes": "barcode-overview"
19+
"Charts": "chart-overview"
20+
"Gauges": "gauge-overview"
21+
"Map": "map-overview"
22+
"ProgressBar": "progressbar-overview"
23+
"Ratings": "rating-overview"
1724
-
18-
title: "Calendar & Scheduling"
25+
title: "Chatbots"
1926
items:
20-
"Calendar": "calendar-overview"
27+
"Conversation UI (Chat)": "chat-overview"
28+
-
29+
categories:
2130
-
22-
title: "Navigation & Layout"
31+
title: "Editors"
32+
items:
33+
"AutoComplete": "autocomplete-overview"
34+
"ComboBox": "combobox-overview"
35+
"DatePicker": "datepicker-overview"
36+
"DateTimePicker": "datetimepicker-overview"
37+
"Entry": "entry-overview"
38+
"ImageEditor": "imageeditor-overview"
39+
"ListPicker": "listpicker-overview"
40+
"MaskedEntries": "maskedentry-overview"
41+
"NumericInput": "numericinput-overview"
42+
"RangeSlider": "rangeslider-overview"
43+
"RichTextEditor": "richtexteditor-overview"
44+
"TemplatedPicker": "templatedpicker-overview"
45+
"TimePicker": "timepicker-overview"
46+
"TimeSpanPicker": "timespanpicker-overview"
47+
"SignaturePad": "signaturepad-overview"
48+
"Slider": "slider-overview"
49+
-
50+
categories:
51+
-
52+
title: "Navigation & Layouts"
2353
items:
24-
"TreeView": "treeview-overview"
25-
"SideDrawer": "sidedrawer-overview"
26-
"TabView": "tabview-overview"
2754
"Accordion": "accordion-overview"
28-
"Expander": "expander-overview"
2955
"DockLayout": "docklayout-overview"
56+
"Expander": "expander-overview"
57+
"NavigationView": "navigationview-overview"
58+
"SideDrawer": "sidedrawer-overview"
59+
"SlideView": "slideview-overview"
60+
"TabView": "tabview-overview"
61+
"TreeView": "treeview-overview"
62+
"WrapLayout": "wraplayout-overview"
63+
-
64+
title: "Calendar & Scheduling"
65+
items:
66+
"Calendar": "calendar-overview"
67+
"Scheduler": "scheduler-overview"
3068
-
3169
title: "Buttons"
3270
items:
3371
"Segmented Control": "segmentedcontrol-overview"
3472
"Button": "button-overview"
3573
"CheckBox": "checkbox-overview"
36-
-
37-
title: "Editors"
38-
items:
39-
"Entry": "entry-overview"
40-
"AutoCompleteView": "autocompleteview-overview"
41-
"NumericInput": "numericinput-overview"
42-
"MaskedInput": "maskedinput-overview"
43-
"Image Editor": "imageeditor-overview"
44-
"DateTime Picker": "datetime-picker-overview"
45-
"List Picker": "list-picker-overview"
46-
"Templated Picker": "templated-picker-overview"
74+
"TemplatedButton": "templatedbutton-overview"
75+
"ToggleButton": "togglebutton-overview"
4776
-
4877
categories:
4978
-
50-
title: "Data Visualization"
51-
items:
52-
"Charts": "chart-overview"
53-
"Map": "map-overview"
54-
"Gauge": "gauge-overview"
55-
"Rating": "rating-overview"
56-
"Barcode": "barcode-overview"
57-
-
5879
title: "Interactivity & UX"
5980
items:
60-
"BusyIndicator": "busyindicator-overview"
61-
"Popup": "popup-overview"
62-
"SlideView": "slideview-overview"
81+
"AIPrompt": "aiprompt-overview"
82+
"BadgeView": "badgeview-overview"
6383
"Border": "border-overview"
84+
"BusyIndicator": "busyindicator-overview"
85+
"GridSplitter": "gridsplitter-overview"
6486
"Path": "path-overview"
87+
"Popup": "popup-overview"
88+
"Toolbar": "toolbar-overview"
6589
-
66-
title: "Document Processing Libraries"
90+
title: "PDF Viewer"
6791
items:
68-
"PdfProcessing": "radpdfprocessing-overview"
69-
"WordsProcessing": "radwordsprocessing-overview"
70-
"SpreadProcessing": "radspreadprocessing-overview"
71-
"SpreadStreamProcessing": "radspreadstreamprocessing-overview"
72-
"ZipLibrary": "radziplibrary-overview"
92+
"PDF Viewer": "pdfviewer-overview"
7393
-
74-
title: "Chatbots"
94+
title: "Document Processing Libraries"
7595
items:
76-
"Conversational UI": "chat-overview"
77-
96+
"PdfProcessing": "document-processing-libraries-overview"
97+
"WordsProcessing": "document-processing-libraries-overview"
98+
"SpreadProcessing": "document-processing-libraries-overview"
99+
"SpreadStreamProcessing": "document-processing-libraries-overview"
100+
"ZipLibrary": "document-processing-libraries-overview"

controls/accordion/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The Telerik UI for .NET MAUI Accordion is a vertically collapsible content panel
1212

1313
![.NET MAUI Accordion Overview](images/accordion-overview.png)
1414

15-
## Key features
15+
## Key Features of the .NET MAUI Accordion
1616

1717
* [Collapsed/expanded states]({%slug accordion-expand-collapse-states%})—Accordion consists of AccordionItems that can present any content. The end users can show or hide this content by interacting with the headers of the control.
1818
* [Collapse All Items]({% slug accordion-expand-collapse-states%}#collapse-all-items)—You can allow the app users to collapse the Accordion through the `CanCollapseAllItems` Boolean property.

controls/aiprompt/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ The component allows you to interact with the output from the AI and execute a s
1414

1515
![.NET MAUI AIPrompt Overview](images/aiprompt-overview.png)
1616

17-
## Key Features
17+
## Key Features of the .NET MAUI AIPrompt
1818

1919
* [Views]({%slug aiprompt-views-overview %})—The AIPrompt provides different views that you can include in it - Input, Output and Commands view. Through interaction with the component, the user can change the currently active view.
2020
* [Suggestions]({%slug aiprompt-suggestions%})—This collection will allow you to populate the AIPrompt component with suggestions that will be displayed to the user prior to sending the request.
8.59 KB
Loading
3.05 KB
Loading
5.22 KB
Loading

controls/autocomplete/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The Telerik UI for .NET MAUI AutoComplete can automatically complete user input
1212

1313
![.NET MAUI AutoComplete Overview](images/autocomplete-getting-started.png "AutoComplete Overview")
1414

15-
## Key features
15+
## Key Features of the .NET MAUI AutoComplete
1616

1717
* [Tokens Support]({%slug autocomplete-tokens-support%})—With AutoComplete you can enable users to search for and pick items in one control.
1818
* [Filtering Options]({%slug autocomplete-filtering%})—You can define the filtering behavior to display all the matches that either `StartsWith` or `Contains` the typed symbols.

controls/autocomplete/styling.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,10 @@ The Telerik UI for .NET MAUI AutoComplete control provides the following Style p
1616
* `BorderBrush`(`Brush`)—Defines the brush of the border around the control.
1717
* `BorderThickness`(`Thickness`)—Defines the thickness of the border around the control.
1818
* `ClearButtonStyle` (of type `Style` with target type `Telerik.Maui.Controls.RadTemplatedButton`)—Defines the style for the clear button.
19-
* `TextInputStyle`(of type `Style` with target type `Telerik.Maui.Controls.RadTextInput`)—Defines the style of the inner `RadTextInput` control.
2019

21-
In addition, you can change the visual appearance of the AutoComplete by defining the following visual states through the .NET MAUI Visual State Manager:
20+
The AutoComplete control uses the [`RadTextInput`]({%slug entry-textinput%}) control internally. To style the input control (`RadTextInput`), use the `TextInputStyle` (of type `Style` with target type `Telerik.Maui.Controls.RadTextInput`).
2221

23-
* `Normal`—Applied when the AutoComplete is in its normal state.
24-
* `Focused`—Applied when the AutoComplete receives focus.
25-
* (Windows Only)`MouseOver`—Applied when the mouse cursor is hovering over the AutoComplete.
26-
* `Disabled`—Applied when the AutoComplete's `IsEnabled` is `False`.
22+
In addition to the available styling properties, you can apply specific [Visual States]({%slug autocomplete-visual-states%}) to the AutoComplete control.
2723

2824
## Suggestion View Styling
2925

@@ -63,6 +59,8 @@ And when an item is selected:
6359

6460
![.NET MAUI AutoComplete Styling Selected Item](images/autocomplete-selected-styling.png)
6561

62+
>tip For a runnable example demonstrating the AutoComplete's Styling options, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to the **AutoComplete > Styling** category.
63+
6664
## Highlight Customization
6765

6866
In case a custom template is used, the user can achieve text highlighting inside the `RadAutoComplete.SuggestionItemTemplate` using `RadHighlightLabel`.
@@ -91,10 +89,12 @@ Here is the result:
9189

9290
![AutoComplete Highlight Customization](images/autocomplete-highlight.png "AutoComplete Highlight Customization")
9391

94-
>important For AutoComplete HighlightText example refer to the [SDKBrowser Demo application]({%slug sdkbrowser-app%}).
92+
>important For AutoComplete HighlightText example, refer to the [SDKBrowser Demo application]({%slug sdkbrowser-app%}) and go to the **AutoComplete > Featrues** category.
9593
9694
## See Also
9795

96+
- [Apply Implicit Style]({%slug style-combobox-autocomplete-entry-implicit-explicit%})
97+
- [Styling the AutoComplete Using Visual States]({%slug style-autocomplete-visual-state-border-telerik-maui%})
9898
- [Data Binding]({%slug autocomplete-data-binding%})
9999
- [Configuration]({%slug autocomplete-configuration%})
100100
- [Suggest Mode]({%slug autocomplete-suggest-mode%})
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: Visual States
3+
page_title: .NET MAUI AutoComplete Documentation - Visual States
4+
description: Learn how to set the border color, background color, and other visual states for the Telerik UI for .NET MAUI AutoComplete control.
5+
position: 15
6+
tags: .net maui, telerik .net maui, ui for .net maui, autocomplete, states, microsoft .net maui
7+
slug: autocomplete-visual-states
8+
---
9+
10+
# .NET MAUI AutoComplete Visual States
11+
12+
This article describes the visual states provided by the AutoComplete control. You can use these visual states to change the appearance of the control based on its state—such as when it’s disabled, focused, hovered, and more.
13+
14+
The AutoComplete provides the following `CommonStates` visual states:
15+
16+
| Visual State | Description |
17+
| ------------- | --------------- |
18+
| `Normal` | Applies when the AutoComplete is in its normal state. |
19+
| `Focused` | Applied when the AutoComplete receives focus. |
20+
| `MouseOver` | (Windows-only) Applied when the mouse cursor is hovering over the AutoComplete. |
21+
| `PointerOver` | (MacCatalyst-only) Applied when the mouse cursor is hovering over the AutoComplete. |
22+
| `Disabled` | Applied when the AutoComplete's `IsEnabled` is `False`. |
23+
24+
## Using the Visual States
25+
26+
The example below demonstrates some of the styling capabilities of the AutoComplete, such as custom `ClearButtonStyle`, `TextInputStyle`, `TextColor`, `PlaceholderColor`, and others. It also shows how to switch its appearance through the .NET MAUI Visual State Manager.
27+
28+
**1.** Add a Style that targets the `RadAutoComplete` to your page's resources and apply all the needed styling properties and the visual states:
29+
30+
<snippet id='autocomplete-custom-styles' />
31+
32+
**2.** Define the AutoComplete in XAML:
33+
34+
<snippet id='autocomplete-styling-xaml'/>
35+
36+
**3.** Create the needed business objects, for example type `Client` with the following properties:
37+
38+
<snippet id='autocomplete-client-businessobject'/>
39+
40+
**4.** Create a `ViewModel` with a collection of `Client` objects:
41+
42+
<snippet id='autocomplete-extended-clients-viewmodel'/>
43+
44+
Here is how the AutoComplete looks when styling is applied:
45+
46+
![.NET MAUI AutoComplete Styling](images/autocomplete-styling.png)
47+
48+
>tip For a runnable example demonstrating the AutoComplete's Visual States, see the [SDKBrowser Demo Application]({%slug sdkbrowser-app%}) and go to the **AutoComplete > Styling** category.
49+
50+
## See Also
51+
52+
- [AutoComplete Styling]({%slug autocomplete-styling%})
53+
- [Apply Implicit Style]({%slug style-combobox-autocomplete-entry-implicit-explicit%})
54+
- [Styling AutoComplete Using Visual States]({%slug style-autocomplete-visual-state-border-telerik-maui%})
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Visual Structure
3+
page_title: .NET MAUI AutoComplete Documentation - AutoComplete Visual Structure
4+
description: Learn more about the visual elements used in the Telerik UI for .NET MAUI AutoComplete control.
5+
position: 0
6+
slug: autocomplete-visual-structure
7+
---
8+
9+
# .NET MAUI AutoComplete Visual Structure
10+
11+
The visual structure of the [.NET MAUI AutoComplete]({%slug autocomplete-overview%}) represents the anatomy of the UI control. Being familiar with the visual elements of the AutoComplete allows you to quickly find the information required to configure them.
12+
13+
The images in this article show the anatomy of the AutoComplete and its building blocks.
14+
15+
![Telerik UI for .NET MAUI AutoComplete Visual Structure](images/autocomplete-placeholder.png "Visual elements of AutoComplete control")
16+
17+
- `Placeholder`&mdash;The text that guides the end-user on what can be entered/searched in the input.
18+
19+
## Tokens Structure
20+
21+
![Telerik UI for .NET MAUI AutoComplete Tokens Visual Structure](images/autocomplete-tokens-template.png "Visual elements of AutoComplete control")
22+
23+
- `Tokens`&mdash;When multiple items are selected from the dropdown list, these items appear as tokens. They can be deselected using their close button.
24+
- `ShowMore Template`&mdash;This template represents a UI that is displayed when the control is not focused and the space is insufficient to show all tokens in a multiple selection scenario.
25+
26+
## Filtering Structure
27+
28+
![Telerik UI for .NET MAUI AutoComplete Filtering Visual Structure](images/autocomplete-focused-text.png "Visual elements of AutoComplete control")
29+
30+
- `Text`&mdash;The text entered in the control's input filed.
31+
- [`RadTextInput`]({%slug entry-textinput%})&mdash;The control used for the text input.
32+
- `Clear Button`&mdash;Clears the selection in the control (for both multiple and single selection scenarios).
33+
- `Filtered Items`&mdash;The items that are displayed after filtering the `ItemsSource` of the AutoComplete control.

0 commit comments

Comments
 (0)