HowTo:Convert Xamarin XAMLs to Maui - Revision history

REP: /* Highly Recommended */

2026-03-11T15:33:33Z

‎Highly Recommended

REP: /* Highly Recommended */ Added sections on Delay/LazyLoad and TemplateConverter

2026-03-11T15:33:05Z

‎Highly Recommended: Added sections on Delay/LazyLoad and TemplateConverter

REP: /* SfPullToRefresh */ Tried to make message not to use PTR clearer as AI didnt get it

2026-03-10T15:49:24Z

‎SfPullToRefresh: Tried to make message not to use PTR clearer as AI didnt get it

REP: /* SfTabView */ added warning and link to UBIKTabView

2026-03-10T15:46:56Z

‎SfTabView: added warning and link to UBIKTabView

REP: Restructured wiki from most to least important, added SfTabView and PTR under Mandatory

2026-03-10T15:41:13Z

Restructured wiki from most to least important, added SfTabView and PTR under Mandatory

REP: Restructured wiki from most to least important

2026-03-10T14:57:08Z

Restructured wiki from most to least important

Show changes

REP: /* UBIKTabView */ Added link to SF docs

2026-02-16T09:31:37Z

‎UBIKTabView: Added link to SF docs

REP: /* Mandatory */ Restructured an unclear section

2026-02-10T15:14:11Z

‎Mandatory: Restructured an unclear section

REP: /* Highly Recommended */

2025-12-15T09:17:39Z

‎Highly Recommended

ARU: /* UBIKTabView */

2025-12-12T11:50:45Z

‎UBIKTabView

@@ Line 608: / Line 608: @@
 ** When used in the content of a UBIKTabView tab, the LazyLoading is handled automatically when the tab is activated (see: UBIKContentArea).
 ** LazyLoading can be manually triggered on any contentview outside of UBIKTabView by triggering the TriggerLazyLoad() method.
 === TemplateConverter for UBIKContentView or ContentControl ===
@@ Line 623: / Line 625: @@
 The former syntax would have been: <syntaxhighlight lang="xml">❌ Content="{Binding [UBIKChildArea], Source={x:Static services:TemplateService.Instance}}"</syntaxhighlight>.
 This 'hardcoded' syntax bypasses the template selection mechanism which includes the various performance improvements mentioned above.
@@ Line 628: / Line 631: @@
 The template formerly called UBIKMainItem has been renamed to UBIKRootItem for consistency.
 The renaming is not mandatory in customizing, however, ensure that the ItemTemplate requested in UBIKRootArea matches the file intended to be used for visualizing root items.
 === CircularImage to AvatarView ===
@@ Line 643: / Line 648: @@
 | <toolkit:AvatarView ImageSource="..." BorderWidth="..." BackgroundColor="..." />
 |}
 === GlyphSize to FontSize and Alignment ===
@@ Line 655: / Line 662: @@
 | <Setter Property="FontSize" Value="16" /><br/><Setter Property="VerticalOptions" Value="Center" /><br/><Setter Property="HorizontalOptions" Value="Center" /><br/><Setter Property="VerticalTextAlignment" Value="Center" /><br/><Setter Property="HorizontalTextAlignment" Value="Center" />
 |}
 === StaticResource to DynamicResource ===

@@ Line 600: / Line 600: @@
 == Highly Recommended ==
 === New name for Root item templates ===
 The template formerly called UBIKMainItem has been renamed to UBIKRootItem for consistency.
@@ Line 765: / Line 790: @@
 |}
+[[Category:How-To|Convert Xamarin XAMLs to Maui]]
 == Recommended ==

@@ Line 449: / Line 449: @@
 === SfPullToRefresh ===
-'''It is recommended to get rid of all SfPullToRefresh controls due to some issues that might occur.''' For more information refer to [[Mobile_XAML#Issues_with_SfPullToRefresh_in_MAUI|this article]]. In our Maui standard client, the PullToRefresh control has already been replaced by a Refresh button in the Context Menu, so there's no need for a custom Refresh button.
+{{Attention|Due to issues in the SfPullToRefresh control it was removed from all standard UBIK UIs and should not be used in customizings. For more information refer to [[Mobile_XAML#Issues_with_SfPullToRefresh_in_MAUI|this article]]. In our Maui standard client, the PullToRefresh control has already been replaced by a Refresh button in the Context Menu, so there's no need for a custom Refresh button, simply to strip the PTR wrapper is enough.}}
 {| class="wikitable"
@@ Line 595: / Line 595: @@
 |}
+[[Category:How-To|Convert Xamarin XAMLs to Maui]]
 == Highly Recommended ==

@@ Line 333: / Line 333: @@
 === SfTabView ===
 ==== Namespace Update ====
@@ Line 442: / Line 443: @@
 ⚠️ Refer to [https://help.syncfusion.com/maui/tabview/migration Syncfusion migration guide] for full property list.
 === SfPullToRefresh ===

@@ Line 332: / Line 332: @@
-== SfTabView ==
+=== SfTabView ===
-=== Namespace Update ===
+==== Namespace Update ====
 '''Update Syncfusion TabView namespace.'''
 Replace the Xamarin namespace with the MAUI equivalent.
@@ Line 346: / Line 346: @@
 |}
-=== Remove Obsolete Converters ===
+==== Remove Obsolete Converters ====
 '''Remove ItemCountToBoolConverter from Resources.'''
 This converter is no longer usable in TabView headers.
@@ Line 358: / Line 358: @@
 |}
-=== Add StringFormatConverter ===
+==== Add StringFormatConverter ====
 '''Use StringFormatConverter for combined header strings.'''
 Syncfusion MAUI TabView uses a single `Header` property instead of templates.
@@ Line 374: / Line 374: @@
 ⚠️ Avoid using bindings in `Parameter1` and `Parameter2` — use static strings only. For complex cases, use `EvalExpression`.
-=== FontImageSource Styling ===
+==== FontImageSource Styling ====
 '''Add local style for FontImageSource.'''
 Global styles are not supported.
@@ Line 391: / Line 391: @@
 |}
-=== TabView Structure ===
+==== TabView Structure ====
 '''Use Grid to wrap TabView.'''
 MAUI TabView requires a different structure and property set.
@@ Line 420: / Line 420: @@
 |}
-=== Property Changes ===
+==== Property Changes ====
 '''Update renamed or removed properties.'''
@@ Line 443: / Line 443: @@
-== SfPullToRefresh ==
+=== SfPullToRefresh ===
 '''It is recommended to get rid of all SfPullToRefresh controls due to some issues that might occur.''' For more information refer to [[Mobile_XAML#Issues_with_SfPullToRefresh_in_MAUI|this article]]. In our Maui standard client, the PullToRefresh control has already been replaced by a Refresh button in the Context Menu, so there's no need for a custom Refresh button.
@@ Line 468: / Line 468: @@
 ⚠️ '''If SfPullToRefresh is still required, the following points should be considered.'''
-=== Namespace Update ===
+==== Namespace Update ====
 '''Update Syncfusion TabView namespace.'''
 Replace the Xamarin namespace with the MAUI equivalent.
@@ Line 480: / Line 480: @@
 |}
-=== Rename SfPullToRefresh properties ===
+==== Rename SfPullToRefresh properties ====
 '''Renamed in Maui, however, currently these properties cause an issue and should not be included in customizings.'''
 SfPullToRefresh:
@@ Line 491: / Line 491: @@
 |}
-=== Avoid multiple SfPullToRefresh controls ===
+==== Avoid multiple SfPullToRefresh controls ====
 '''To prevent an issue that causes the app to freeze, avoid placing more than one SfPullToRefresh controls as siblings in a xaml hierarchy'''. If switching between contents in a SfPullToRefresh control is necessary use separate DataTemplates for the contents and use e.g. a DataTrigger to set one of them as the ControlTemplate of a ContentControl inside the SfPullToRefresh control.
@@ Line 555: / Line 555: @@
 |}
-=== Avoid using SyncFusion ListViews directly in SfPullToRefresh controls ===
+==== Avoid using SyncFusion ListViews directly in SfPullToRefresh controls ====
 '''To prevent an issue on some Android devices that can cause some items in a SfListViewExt to be rendered incorrectly or not at all after triggering a PullToRefresh, avoid placing a SfListViewExt directly in a SfPullToRefresh control'''.
 Instead, wrap the ListView in a DataTemplate and use it in a ContentControl as a child of the SfPullToRefresh control, as shown in the Xaml example below.

@@ Line 293: / Line 293: @@
 === UBIKTabView ===
 UBIKTabView has been adapted so that it now supports lazy loading when used in combination with a UBIKContentView or ContentControl. This results in a performance boost because the contents of non-selected tabs are no longer rendered in the UI automatically unless the tab is explicitly selected by the user. Therefore, the LazyLoading property should be set to true for tabs that are not the “default” tabs—i.e., tabs that are not initially selected when a page is opened (Property or Document tabs).
 Add the following namespace to use the UBIKTabView:

@@ Line 433: / Line 433: @@
 === Syncfusion control updates ===
-'''There are some other properties that have changed their names on SfListView/SfListViewExt. We don't use them in our standard XAMLs. But if you use them in customizings, please refer to https://help.syncfusion.com/maui/listview/migration for the complete list.'''
+There are some other properties that have changed their names on '''SfListView/SfListViewExt'''. We don't use them in our standard XAMLs. But if you use them in customizings, please refer to https://help.syncfusion.com/maui/listview/migration for the complete list.
 {| class="wikitable"
 ! Xamarin
 ! MAUI
 |-
-| <syntaxhighlight lang="xml">
+| <syntaxhighlight lang="xml">ItemHolding</syntaxhighlight>
-SfListViewExt:
+| <syntaxhighlight lang="xml">ItemLongPress</syntaxhighlight>
-    * ItemHolding
+|-
-</syntaxhighlight>
+| <syntaxhighlight lang="xml">LeftSwipeTemplate, RightSwipeTemplate</syntaxhighlight>
-| ItemLongPress
+| <syntaxhighlight lang="xml">StartSwipeTemplate, EndSwipeTemplate</syntaxhighlight>
-|}
+|-
+| <syntaxhighlight lang="xml"><sync:SfListView.LayoutManager></syntaxhighlight>
-=== Syncfusion control updates ===
+| <syntaxhighlight lang="xml"><sync:SfListView.ItemsLayout></syntaxhighlight>
-{| class="wikitable"
-! Xamarin
-! MAUI
 |-
 |}
 === TemplateService binding for extracted templates ===
@@ Line 548: / Line 531: @@
 ⚠️ Please refer to the wiki for more details and possibilities (e.g., if the value contains multiple elements): [https://wiki.augmensys.com/index.php?title=XAML_Tips#Platform_and_Device-specific_UI_with_OnPlatform_and_OnIdiom Platform and Device-specific UI with OnPlatform and OnIdiom].
-[[Category:How-To|Convert Xamarin XAMLs to Maui]]
-[[Category:Mobile|Convert Xamarin XAMLs to Maui]]
-[[Category:XAML|Convert Xamarin XAMLs to Maui]]
 === Remove default ControlTemplate ===

@@ Line 288: / Line 288: @@
 === UBIKTabView ===
-We have adapted our UBIKTabView for MAUI so that, when used in combination with a UBIKContentView or ContentControl, it now supports lazy loading. This results in a performance boost because the contents of non-selected tabs are no longer rendered in the UI automatically unless the tab is explicitly selected by the user. Therefore, the LazyLoading property should be set to true for tabs that are not the “default” tabs—i.e., tabs that are not initially selected when a page is opened (Property or Document tabs).
+UBIKTabView has been adapted so that it now supports lazy loading when used in combination with a UBIKContentView or ContentControl. This results in a performance boost because the contents of non-selected tabs are no longer rendered in the UI automatically unless the tab is explicitly selected by the user. Therefore, the LazyLoading property should be set to true for tabs that are not the “default” tabs—i.e., tabs that are not initially selected when a page is opened (Property or Document tabs).
 Add the following namespace to use the UBIKTabView:
@@ Line 296: / Line 296: @@
-'''From a performance perspective, our UBIKTabView should be used instead of the SfTabView going forward, as it supports lazy loading.'''
+'''From a performance perspective, our UBIKTabView should be used instead of the SfTabView going forward, as it supports lazy loading.'''{{Version/MobileSince|5.1}}
-{| class="wikitable"
+{| class="wikitable" style="width:100%; table-layout:fixed;"
-! Xamarin
+! style="width:60%;" | Xamarin
-! MAUI
+! style="width:40%;" | MAUI
 |-
+|