Migrate from Xamarin.Forms SfParallaxView to .NET MAUI SfParallaxView

21 May 20251 minute to read

The SfParallaxView has been rebuilt from scratch using the upgraded APIs and performance capabilities of the .NET MAUI graphics library and framework layouts. To maintain API naming consistency in .NET MAUI SfParallaxView, some APIs have been renamed. The following sections detail the changes between Xamarin and .NET MAUI implementations of SfParallaxView.

Namespaces

Xamarin	.NET MAUI
Syncfusion.XForms.ParallaxView	Syncfusion.Maui.ParallaxView

To facilitate easier migration, most of the APIs from the Xamarin SfParallaxView have been preserved in the .NET MAUI SfParallaxView. Please refer to the following details and API migration information.

Initialize control

To initialize the control, import the parallax view namespace and initialize SfParallaxView as shown in the following code samples:

Xamarin

Xamarin
XAML C# `<ContentPage . . . xmlns:parallax="clr-namespace:Syncfusion.XForms.ParallaxView;assembly=Syncfusion.XForms.ParallaxView"> <parallax:SfParallaxView/> </ContentPage>` `using Syncfusion.XForms.ParallaxView; ... SfParallaxView parallax = new SfParallaxView(); this.Content = parallax;`
.NET MAUI
XAML C# `<ContentPage . . . xmlns:parallax="clr-namespace:Syncfusion.Maui.ParallaxView;assembly=Syncfusion.Maui.ParallaxView"> <parallax:SfParallaxView/> </ContentPage>` `using Syncfusion.Maui.ParallaxView; . . . SfParallaxView parallax = new SfParallaxView(); this.Content = parallax;`

XAML
C#
<ContentPage
    . . .
    xmlns:parallax="clr-namespace:Syncfusion.XForms.ParallaxView;assembly=Syncfusion.XForms.ParallaxView">

    <parallax:SfParallaxView/>

</ContentPage>
using Syncfusion.XForms.ParallaxView;
...

SfParallaxView parallax = new SfParallaxView();
this.Content = parallax;

.NET MAUI

XAML
C#
<ContentPage
    . . .    
    xmlns:parallax="clr-namespace:Syncfusion.Maui.ParallaxView;assembly=Syncfusion.Maui.ParallaxView">

    <parallax:SfParallaxView/>

</ContentPage>
using Syncfusion.Maui.ParallaxView;
. . .
SfParallaxView parallax = new SfParallaxView();
this.Content = parallax;

Classes

Namespace	Class
Syncfusion.Maui.ParallaxView	SfParallaxView
Syncfusion.Maui.Core	ParallaxScrollingEventArgs

Xamarin	.NET MAUI	Description
SfParallaxView	SfParallaxView	SfParallaxView control provides scrolling for any control that implements the IParallaxView.
ParallaxScrollingEventArgs	ParallaxScrollingEventArgs	Defines the scrolling event args

Interface

Namespace	Interface
Syncfusion.Maui.Core	IParallaxView

Xamarin	.NET MAUI	Description
IParallaxView	IParallaxView	Defines an event and a property to perform parallax scrolling.

Enums

Namespace	Enums
Syncfusion.Maui.ParallaxView	Orientation

Xamarin	.NET MAUI	Description
Orientation	Orientation	Defines the orientation of the view

API Migration

Parallax View

The following table illustrates the API migration for the parallax view:

Xamarin	.NET MAUI
Content	Content
Source	Source
Speed	Speed
Orientation	Orientation
Scrolling	Scrolling
ScrollX	ScrollX
ScrollY	ScrollY
CanAnimate	CanAnimate
ScrollContentSize	ScrollContentSize

Support and feedback

If you are unable to find the migration information you require in the self-help resources listed above, please contact us by creating a support ticket. If you don’t find what you need, please request it from our feedback portal.