Getting Started with .NET MAUI Chart

14 Mar 202311 minutes to read

This section explains how to populate the circular chart with data, a title, data labels, a legend, and tooltips, as well as the essential aspects for getting started with the circular chart.

To get start quickly with our .NET MAUI Circular Chart, you can check the below video.

Creating an application using the .NET MAUI chart

  1. Create a new .NET MAUI application in Visual Studio.
  2. Syncfusion .NET MAUI components are available in nuget.org. To add SfCircularChart to your project, open the NuGet package manager in Visual Studio, search for Syncfusion.Maui.Charts and then install it.
  3. To initialize the control, import the Chart namespace.
  4. Initialize SfCircularChart.
<ContentPage   
    . . .
    xmlns:chart="clr-namespace:Syncfusion.Maui.Charts;assembly=Syncfusion.Maui.Charts">

    <chart:SfCircularChart/>
</ContentPage>
using Syncfusion.Maui.Charts;
. . .

public partial class MainWindow : ContentPage
{
    public MainPage()
    {
        this.InitializeComponent();
        SfCircularChart chart = new SfCircularChart();
    }
}

Register the handler

Syncfusion.Maui.Core nuget is a dependent package for all Syncfusion controls of .NET MAUI. In the MauiProgram.cs file, register the handler for Syncfusion core.

  • C#
  • using Microsoft.Maui;
    using Microsoft.Maui.Hosting;
    using Microsoft.Maui.Controls.Compatibility;
    using Microsoft.Maui.Controls.Hosting;
    using Microsoft.Maui.Controls.Xaml;
    using Syncfusion.Maui.Core.Hosting;
    
    namespace ChartGettingStarted
    {
        public static class MauiProgram
        {
            public static MauiApp CreateMauiApp()
            {
                var builder = MauiApp.CreateBuilder();
                builder
                .UseMauiApp<App>()
                .ConfigureSyncfusionCore()
                .ConfigureFonts(fonts =>
                {
                    fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                });
    
                return builder.Build();
            }
        }
    }

    Initialize view model

    Now, let us define a simple data model that represents a data point in the chart.

    public class Sales
    {
        public string Product { get; set; }
        public double SalesRate { get; set; }
    }

    Next, create a view model class and initialize a list of Model objects as follows.

    public class ChartViewModel
    {
        public List<Sales> Data { get; set; }
    
        public ChartViewModel()
        {
            Data = new List<Sales>()
            {
                new Sales(){Product = "iPad", SalesRate = 25},
                new Sales(){Product = "iPhone", SalesRate = 35},
                new Sales(){Product = "MacBook", SalesRate = 15},
                new Sales(){Product = "Mac", SalesRate = 5},
                new Sales(){Product = "Others", SalesRate = 10},
            };
        }
    }

    Create a ViewModel instance and set it as the chart’s BindingContext. This enables property binding from ViewModel class.

    NOTE

    Add namespace of ViewModel class to your XAML Page, if you prefer to set BindingContext in XAML.

    <ContentPage
        . . .
        xmlns:chart="clr-namespace:Syncfusion.Maui.Charts;assembly=Syncfusion.Maui.Charts"
        xmlns:model="clr-namespace:ChartGettingStarted">
    
        <chart:SfCircularChart>
            <chart:SfCircularChart.BindingContext>
            <model:ChartViewModel/>
            </chart:SfCircularChart.BindingContext>
        </chart:SfCircularChart>
    </ContentPage>
    ChartViewModel viewModel = new ChartViewModel();
    chart.BindingContext = viewModel;

    Populate chart with data

    Adding PieSeries to the charts Series collection and binding Data to the series ItemsSource property from its BindingContext to create our own Product Sales Pie chart.

    NOTE

    The circular chart has Series as its default content.

    NOTE

    To plot the series, the XBindingPath and YBindingPath properties must be configured so that the chart may get values from the respective properties in the data model.

    <chart:SfCircularChart>
        . . .
        <chart:PieSeries ItemsSource="{Binding Data}" 
                        XBindingPath="Product" 
                        YBindingPath="SalesRate"/>
    </chart:SfCircularChart>
    SfCircularChart chart = new SfCircularChart();
    ChartViewModel viewModel = new ChartViewModel();
    chart.BindingContext = viewModel;
    PieSeries series = new PieSeries();
    series.ItemsSource = viewModel.Data;
    series.XBindingPath = "Product";
    series.YBindingPath = "SalesRate";
    chart.Series.Add(series);

    Add a title

    The title of the chart acts as the title to provide quick information to the user about the data being plotted in the chart. You can set title using the Title property of circular chart as follows.

    <chart:SfCircularChart>
        <chart:SfCircularChart.Title>
            <Label Text="PRODUCT SALES"/>
        </chart:SfCircularChart.Title>
        . . .
    </chart:SfCircularChart>
    SfCircularChart chart = new SfCircularChart();
    chart.Title = new Label
    {
        Text = "PRODUCT SALES"
    };

    Enable the data labels

    The ShowDataLabels property of series can be used to enable data labels to improve the readability of the circular chart. The label visibility is set to False by default.

    <chart:SfCircularChart>
        . . .
        <chart:PieSeries ShowDataLabels="True"/>
    </chart:SfCircularChart>
    SfCircularChart chart = new SfCircularChart();
    . . .
    PieSeries series = new PieSeries();
    series.ShowDataLabels = true;
    chart.Series.Add(series);

    Enable a legend

    The legend provides information about the data point displayed in the circular chart. The Legend property of the chart was used to enable it.

    <chart:SfCircularChart>
        . . .
        <chart:SfCircularChart.Legend>
        <chart:ChartLegend/>
        </chart:SfCircularChart.Legend>
    </chart:SfCircularChart>
    SfCircularChart chart = new SfCircularChart();
    . . .
    chart.Legend = new ChartLegend();

    Enable Tooltip

    Tooltips are used to show information about the segment, when mouse over on it. Enable tooltip by setting series EnableTooltip property as true.

    <chart:SfCircularChart>
        . . .
        <chart:PieSeries EnableTooltip="True"/>
    </chart:SfCircularChart>
    SfCircularChart chart = new SfCircularChart();
    . . .
    PieSeries series = new PieSeries();
    series.EnableTooltip = true;
    chart.Series.Add(series);

    The following code example gives you the complete code of above configurations.

    <chart:SfCircularChart>
        <chart:SfCircularChart.Title>
            <Label Text="PRODUCT SALES"/>
        </chart:SfCircularChart.Title>
        <chart:SfCircularChart.BindingContext>
            <model:ChartViewModel/>
        </chart:SfCircularChart.BindingContext>
        <chart:SfCircularChart.Legend>
            <chart:ChartLegend/>
        </chart:SfCircularChart.Legend>
        <chart:PieSeries
    		ItemsSource="{Binding Data}"
    		ShowDataLabels="True"
    		XBindingPath="Product"
    		EnableTooltip="True"
    		YBindingPath="SalesRate"/>
    </chart:SfCircularChart>
    using Syncfusion.Maui.Charts;
    . . .
    public partial class MainPage : ContentPage
    {   
        public MainWindow()
        {
            SfCircularChart chart = new SfCircularChart();
            chart.Title = new Label
            {
                Text = "PRODUCT SALES"
            };
            chart.Legend = new ChartLegend();
            ChartViewModel viewModel = new ChartViewModel();
            chart.BindingContext = viewModel;
    
            PieSeries series = new PieSeries();
            series.ItemsSource = viewModel.Data;
            series.XBindingPath = "Product";
            series.YBindingPath = "SalesRate";
            series.EnableTooltip = true;
            series.ShowDataLabels = true;
            chart.Series.Add(series);
            this.Content = chart;
        }
    }

    Pie chart in .NET MAUI Chart

    You can find the complete getting started sample from this link.