Skip to main content
net11.0

Avalonia.Controls.Maui.Compatibility provides handlers for legacy/obsolete MAUI controls (ListView, Frame, TableView, Cells) using Avalonia-based implementations. These controls are provided for backward compatibility with apps porting from Xamarin.Forms.

Published
Aug 12, 2026
2mo ago
Total Downloads
1.0K
1,048

Install

dotnet add package Avalonia.Controls.Maui.Compatibility --version 11.0.0-preview.7.26224.328
ProductVersions
.NET
net11.0

README

Avalonia.Controls.Maui.Compatibility

Provides Avalonia-based handlers for deprecated and legacy .NET MAUI controls. This package is intended for apps migrating from Xamarin.Forms or older MAUI versions that still use controls like ListView, Frame, and TableView.

Getting Started

Install this package alongside Avalonia.Controls.Maui and register the compatibility handlers in your MauiProgram.cs. Call UseAvaloniaCompatibility() after UseAvaloniaApp():

using Avalonia.Controls.Maui;
using Avalonia.Controls.Maui.Compatibility;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .UseAvaloniaApp()
            .UseAvaloniaCompatibility();

        return builder.Build();
    }
}

Supported Controls

Control Description
Frame Legacy container with border, shadow, and corner radius
ListView Legacy list control with item templates, grouping, headers/footers, and pull-to-refresh
TableView Legacy table control for displaying data rows and settings-style forms
TextCell Cell displaying primary and secondary text
ImageCell Cell displaying an image alongside primary and secondary text
SwitchCell Cell with a label and toggle switch
EntryCell Cell with a label and text input
ViewCell Cell with a custom view template

For new development, prefer the modern MAUI equivalents (Border, CollectionView, etc.) which are handled by the core Avalonia.Controls.Maui package.

License

This project is licensed under the MIT License.

Changes from Previous Version

No structural changes between v11.0.0-preview.6.26198.1455 and v11.0.0-preview.7.26224.328.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

This version is marked prerelease. Validate its API and upgrade path before production use.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.