Skip to content

Commit 118fe90

Browse files
Merge pull request #1192 from telerik/didi/update-tabview-images-docs
Didi/update tabview images docs
2 parents c74677a + c4cefbf commit 118fe90

File tree

12 files changed

+43
-24
lines changed

12 files changed

+43
-24
lines changed

controls/autocomplete/configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ By default the search is triggered as soon as the user types into the input fiel
6565

6666
* `ShowSuggestionView` (`bool`)—Determine the visibility of the popup containing the search results of the AutoComplete. The default value is `True`.
6767
* `SuggestionViewHeight` (`double`)—Defines the height of the `SuggestionView`.
68-
* `SuggestionViewMaxHeight` (`double`)—Defines the max height of the `SuggestionView`. Always set the `SuggestionViewMaxHeight`, so that you can have a predefined heigh for the suggestion view. If using both the `SuggestionViewMaxHeight` and `SuggestionViewHeight` properties, the max height value must be heigher.
68+
* `SuggestionViewMaxHeight` (`double`)—Defines the max height of the `SuggestionView`. Always set the `SuggestionViewMaxHeight`, so that you can have a predefined height for the suggestion view. If using both the `SuggestionViewMaxHeight` and `SuggestionViewHeight` properties, the max height value must be higher.
6969
* `SuggestionViewBorderColor` (`Color`)—Defines the color of the suggestion view border (drop-down).
7070
* `SuggestionViewBorderThickness` (`Thickness`)—Defines the thickness of the border around the suggestion view.
7171
* `SuggestionViewCornerRadius` (`Thickness`)—Defines the corner radius applied to the suggestion view.

controls/autocomplete/display-text.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ The AutoComplete control provides the option to format the visualized text in th
1414

1515
To define the formatter of the selected item, you can use the following options:
1616

17-
* Set the `DisplayTextFortammer` property and define the name of the property from the business object which will be displayed after formatting.
17+
* Set the `DisplayTextFormatter` property and define the name of the property from the business object which will be displayed after formatting.
1818
* Create a custom class that inherits from `IDisplayTextFormatter` and implement a custom logic how the selected item can be formatted.
1919

2020
## Example

controls/autocomplete/overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@ The Telerik UI for .NET MAUI AutoComplete can automatically complete user input
2323
* [Custom Templates]({%slug autocomplete-custom-templates%})—If any of the default templates do not fit in a particular scenario, you can define a custom template.
2424
* [Remote Search]({%slug autocomplete-remote-search%})—Allows you to take the user input, trigger a custom searching algorithm and assign the results to the ItemSource of the AutoComplete.
2525
* [Suggestion view visibility]({%slug autocomplete-configuration%}#suggestionview-visibility)—AutoComplete provides the ability to hide the view with the suggestions.
26-
* [Suggestion view position]—AutoComplete gives your the option to specify whether the `SuggestionView` will be displayed—above or under the control.
26+
* [Suggestion view position]({%slug autocomplete-configuration%}#suggestionview-position)—AutoComplete gives you the option to specify whether the `SuggestionView` will be displayed—above or under the control.
2727
* [Highlight customization]({%slug autocomplete-styling%}#hightlight-customization)—You can customize the highlight color of the suggestion items.
28-
* [Nested properties support]()—This allows binding of a complex object to the `TextSearchPath` property.
28+
* [Nested properties support]({%slug autocomplete-data-binding%})—This allows binding of a complex object to the `TextSearchPath` property.
2929
* [Styling options]({%slug autocomplete-styling%})—For changing the control's border brush and thickness, font options, suggestion item highlight text color and more.
3030

3131
# Next Steps

controls/tabview/getting-started.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,12 +33,16 @@ Before adding the TabView, you need to:
3333
* To define the header of a `TabViewItem` use its `HeaderText` property as in the example.
3434

3535
<snippet id='tabview-getting-started-xaml'/>
36+
<snippet id='tabview-getting-started-csharp'/>
3637

3738
**2.** Add the following namespace:
3839

3940
```XAML
4041
xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
4142
```
43+
```C#
44+
using Telerik.Maui.Controls;
45+
```
4246

4347
**3.** Register the Telerik controls through the `Telerik.Maui.Controls.Compatibility.UseTelerik` extension method called inside the `CreateMauiApp` method of the `MauiProgram.cs` file of your project:
4448

906 Bytes
Loading
1.17 KB
Loading

controls/tabview/overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ If you prefer video instructions, watch this short MAUI TabView video tutorial.
2727
* [Header Customization]({%slug tabview-configuration%})&mdash;TabView provides means for customizing the header area containing the tabs—through the `HeaderStyle` property you can change its position, orientation, and spacing between the tabs; through the `HeaderTemplate` property you can modify its look and feel.
2828
* [Image support in the header]({%slug tabview-item%})&mdash;add images inside the header. In addition you can controls the position of the image and the spacing between the image and the header text.
2929
* [Change the header position]({%slug tabview-configuration%}#setting-the-headers-position) to top, bottom, left or right.
30+
* [Data Binding]({%slug tabview-data-binding%})&mdash;TabView supports binding to a complex object through the `ItemsSource` property.
3031
* [Tabs Customization]({%slug tabview-item%})&mdash;You can customize the appearance of each tab. Each tab has a header and content. The `TabViewItem` class gives you the option to set Tab's header text, add an image which will be displayed in the header, add a content and decide whether the tab will be selected, visible and enabled.
3132
* [Flexible styling API]({%slug tabview-styling%})&mdash;The TabView provides a number of styling capabilities, which enable you to style its header, header items and content. In addition, there is a styling option for the TabView control.
3233
* [Templates]({%slug tabview-templates%})&mdash;The TabView provides templates for its header, header items and content.

controls/tabview/selection.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,23 @@ position: 7
1111

1212
The Telerik TabView for .NET MAUI exposes properties that help you work with the item selection:
1313

14+
## Selection through the UI
15+
16+
The `TabViewItem` can be selected through the UI by tapping on the header item. When tapping on the header item, the `SelectedIndex` and `SelectedItem` properties get updated.
17+
18+
## Programmatic Selection
19+
20+
You can programmatically select a `TabViewItem` by setting the following properties:
21+
1422
* `SelectedItem` (of type `Telerik.Maui.Controls.TabViewItem`)&mdash;Defines the selected item. The value of this property affects which header item is selected in the header area and which content is displayed in the content area.
1523
* `SelectedIndex` (`int`)&mdash;Specifies the index of the currently selected `TabViewItem`. The value of this property affects which header item is selected in the header area and which content is displayed in the content area.
1624

17-
* `TabViewItem` can be selected by setting its `IsSelected`(`bool`) property to `True`.
25+
* `IsSelected` (`bool`)&mdash;Set the property directly to the `TabViewItem` to initiale a selection.
26+
27+
### Animation
1828

19-
* `AnimationEasing` (`Microsoft.Maui.Easing`)&mdash;Specifies the easing of the animation that is run when the selected index changes.
20-
* `AnimationDuration` (`int`)&mdash;Specifies the duration in milliseconds of the animation that is run when the selected index changes.
29+
* `AnimationEasing` (`Microsoft.Maui.Easing`)&mdash;Specifies the easing of the animation that is run when the value of the `SelectedIndex` property changes.
30+
* `AnimationDuration` (`int`)&mdash;Specifies the duration in milliseconds of the animation that is run when the value of the `SelectedIndex` property changes.
2131

2232
**Example with Selected Item**
2333

controls/tabview/tabviewitem.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,14 +34,21 @@ The following example shows how to add TabView items directly to the Items colle
3434
<telerik:TabViewItem HeaderText="View" />
3535
</telerik:RadTabView>
3636
```
37+
```C#
38+
var tabView = new RadTabView();
39+
tabView.Items.Add(new Telerik.Maui.Controls.TabViewItem { HeaderText="Home" });
40+
tabView.Items.Add(new Telerik.Maui.Controls.TabViewItem { HeaderText = "Folder" });
41+
tabView.Items.Add(new Telerik.Maui.Controls.TabViewItem { HeaderText = "View" });
42+
```
3743

3844
## Defining Content
3945

4046
You can define the content of a `TabViewItem` via its `Content` property or `ContentTemplate` property.
4147

42-
### Example with Content Property
48+
**Example with Content Property**
4349

4450
<snippet id='tabview-getting-started-xaml' />
51+
<snippet id='tabview-getting-started-csharp' />
4552

4653
> The TabView control displays only the content of the selected item.
4754

controls/tabview/templates.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ position: 14
1111

1212
The TabView provides set of templates for its elements. If you want to change the TabView appearance you can use the provided templates:
1313

14-
* `HeaderTemplate` (`ControlTemplate`)&mdash;Defines the template of the entire header area. This includes the tabs in the Header (Header area + Header items).
14+
* `HeaderTemplate` (`ControlTemplate`)&mdash;Defines the template of the entire TabView Header. This includes the tabs in the Header (Header area + Header items).
1515
* `HeaderItemTemplate` (`ControlTemplate`)&mdash;Defines the template of the individual header items.
16-
* `ContentTemplate` (`ControlTemplate`)&mdash;Defined the template of the entire content area.
16+
* `ContentTemplate` (`ControlTemplate`)&mdash;Defined the template of the entire TabView Content.
1717

1818
![.NET MAUI TabView Visual Structure](images/visual-structure.png "Visual elements of TabView control")
1919

@@ -39,13 +39,8 @@ The TabView provides set of templates for its elements. If you want to change th
3939
</telerik:RadTabView>
4040
```
4141

42-
And the namespace used:
43-
44-
```XAML
45-
xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
46-
```
47-
48-
>note If you do not want to change the default templates you can customize the look of the TabView, TabView Header, TabView `HeaderItem` and TabView Content using the flexible styling API. For more details review the [TabView Styling article]({%slug tabview-styling%}).
42+
> If you want to review the default TabView `HeaderTemplate`, `HeaderItemTemplate` and `ContentTemplate`, add the [TelerikTheming]({%slug themes-overview%}) to the project and go to `TelerikTheming/Styles/Platform/TabView.xaml` file.
43+
> If you do not want to change the default templates you can customize the look of the TabView, TabView Header, TabView `HeaderItem` and TabView Content using the flexible styling API. For more details review the [TabView Styling article]({%slug tabview-styling%}).
4944
5045
## See Also
5146

0 commit comments

Comments
 (0)