Syncfusion.Maui.GridSplitter

Syncfusion .NET MAUI Grid Splitter (SfGridSplitter)

The Syncfusion .NET MAUI Grid Splitter is a layout control that arranges content in resizable panes separated by draggable splitters. Users can adjust the size of adjacent rows or columns simply by dragging a splitter bar, and panes can also be collapsed and expanded on demand. Build rich resizable split views for Android, iOS, macOS, and Windows from a single codebase.

Documentation · Getting Started · API Reference · Demos on GitHub · Product Page · Release Notes

Using this package with an AI coding agent

Before generating Syncfusion code, ask your AI coding agent to run the Syncfusion setup using the following prompt:

Set up this project for Syncfusion before generating code. Fetch and follow the official instructions at https://ai.syncfusion.com, then report the detected platform, installed skill pack, MCP status, and any required licensing action.

The setup detects your project’s platform and loads the appropriate Syncfusion skill pack. No Syncfusion account or MCP key is required to install or read Syncfusion agent skills.

Platform reference: https://ai.syncfusion.com/maui/llms.txt

---

Key features

Layout and panes

• Arrange panes side-by-side with Horizontal (default), or stack them with Vertical.
• Add any number of panes through the SplitterPanes collection.
• Each SplitterPane hosts any view in its Content property and supports proportional, fixed, and fill sizing through Size (for example, 2*, 200, or *).

Resizing

• Drag the splitter bar to resize adjacent panes with smooth, live feedback.
• Constrain resizing per pane with MinimumSize, MaximumSize, IsResizable, and sensible default minimums for inner panes.
• Control the splitter bar thickness with the SeparatorSize property.
• Follow the resize interaction with the ResizeStarted, Resizing, and ResizeEnded events.

Collapse and expand

• Show or hide panes interactively using built-in expand and collapse buttons.
• Collapse or expand panes programmatically through the IsCollapsed property.
• Control whether a pane participates with the IsCollapsible property.
• Follow the expand and collapse interaction with the Collapsing, Collapsed, Expanding, and Expanded events.

Look and feel

• Customize the splitter bar with SeparatorBackground, ResizeIconColor, and ExpandCollapseIconColor.
• Replace the resize handle entirely with a custom ResizeIconTemplate.
• Theme the pane backgrounds and borders with built-in light and dark theme support.

More

• Right-to-left (RTL) layout support.
• Keyboard and accessibility support.
• A shared codebase and API that behave consistently across Android, iOS, macOS, and Windows.

---

Supported platforms

Platform	Target framework
Android	net9.0-android, net10.0-android
iOS	net9.0-ios, net10.0-ios
macOS (Mac Catalyst)	net9.0-maccatalyst, net10.0-maccatalyst
Windows	net9.0-windows10.0.19041, net10.0-windows10.0.19041

Minimum OS versions follow the .NET MAUI supported platforms.

---

Installation

.NET CLI

dotnet add package Syncfusion.Maui.GridSplitter

Package Manager Console

Install-Package Syncfusion.Maui.GridSplitter

---

Getting started

1. Register the Syncfusion core handler

In MauiProgram.cs, call ConfigureSyncfusionCore():

using Syncfusion.Maui.Core.Hosting;

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

        return builder.Build();
    }
}

2. Add SfGridSplitter to your page

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:syncfusion="clr-namespace:Syncfusion.Maui.GridSplitter;assembly=Syncfusion.Maui.GridSplitter"
             x:Class="YourAppNamespace.MainPage">

    <syncfusion:SfGridSplitter>
        <syncfusion:SplitterPane Size="2*">
            <syncfusion:SplitterPane.Content>
                <Label Text="Pane 1"
                       HorizontalOptions="Center"
                       VerticalOptions="Center" />
            </syncfusion:SplitterPane.Content>
        </syncfusion:SplitterPane>

        <syncfusion:SplitterPane Size="1*">
            <syncfusion:SplitterPane.Content>
                <Label Text="Pane 2"
                       HorizontalOptions="Center"
                       VerticalOptions="Center" />
            </syncfusion:SplitterPane.Content>
        </syncfusion:SplitterPane>
    </syncfusion:SfGridSplitter>

</ContentPage>

Run the app. Two resizable panes appear side-by-side, separated by a draggable splitter bar.

---

Common scenarios

Stack panes top to bottom

<syncfusion:SfGridSplitter Orientation="Vertical">
    <syncfusion:SplitterPane Size="1*" />
    <syncfusion:SplitterPane Size="2*" />
</syncfusion:SfGridSplitter>

Constrain a pane

<syncfusion:SfGridSplitter>
    <syncfusion:SplitterPane Size="200"
                             MinimumSize="150"
                             MaximumSize="300" />
    <syncfusion:SplitterPane Size="*"
                             IsCollapsible="False" />
</syncfusion:SfGridSplitter>

Style the splitter bar

<syncfusion:SfGridSplitter SeparatorSize="12"
                           SeparatorBackground="#F0F0F0"
                           ResizeIconColor="#49454F"
                           ExpandCollapseIconColor="#6750A4" />

Collapse or expand a pane in code

gridSplitter.SplitterPanes[1].IsCollapsed = true;

For more features, see the Grid Splitter documentation.

---

Dependencies

Installing this package also installs the following packages:

• Microsoft.Maui.Controls
• Syncfusion.Maui.Core

---

License

This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this component, is subject to the terms and conditions of Syncfusion's EULA. You can purchase a license here or start a free 30-day trial here.

Register your license key

Register the key in App.xaml.cs before the app is built:

Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");

For details, see Licensing overview.

---

Support and feedback

• Support tickets: Syncfusion Support Portal
• Community forums: .NET MAUI Forums
• Feature requests and bug reports: Feedback Portal
• Samples: Syncfusion .NET MAUI demos on GitHub

---

About Syncfusion

Founded in 2001 and headquartered in Research Triangle Park, N.C., Syncfusion has more than 26,000+ customers and more than 1 million users, including large financial institutions, Fortune 500 companies, and global IT consultancies.

Today, we provide 1600+ components and frameworks for web (Blazor, ASP.NET Core, ASP.NET MVC, ASP.NET WebForms, JavaScript, Angular, React, Vue, and Flutter), mobile (.NET MAUI, Xamarin, Flutter, UWP, and JavaScript), and desktop development (WinForms, WPF, WinUI, Flutter and UWP). We provide ready-to-deploy enterprise software for dashboards, reports, data integration, and big data processing. Many customers have saved millions in licensing fees by deploying our software.

---

[email protected] | www.syncfusion.com | Toll Free: 1-888-9 DOTNET