Getting started with Blazor Range Selector component

20 Apr 2021 / 3 minutes to read

This section briefly explains how to include a Range Navigator component in your Blazor server-side application. You can refer to our Getting Started with Syncfusion Blazor for server-side in Visual Studio 2019 page for introduction and configuring common specifications.

Importing Syncfusion Blazor Range Navigator component in the application

Install Syncfusion.Blazor NuGet package to the application by using the NuGet Package Manager.
You can add the client-side resources through CDN or from NuGet package in the HEAD element of the ~/Pages/_Host.cshtml page.

<head>
<link href="_content/Syncfusion.Blazor.Themes/bootstrap4.css" rel="stylesheet" />
<!---CDN--->
@*<link href="https://cdn.syncfusion.com/blazor/18.4.42/styles/bootstrap4.css" rel="stylesheet" />*@
</head>

For Internet Explorer 11, kindly refer the polyfills. Refer the documentation for more information.

<head>
<link href="https://cdn.syncfusion.com/blazor/18.4.42/styles/bootstrap4.css" rel="stylesheet" />
<script src="https://github.com/Daddoon/Blazor.Polyfill/releases/download/3.0.1/blazor.polyfill.min.js"></script>
</head>

Adding component package to the application

Open the ~/_Imports.razor file and include the Syncfusion.Blazor.Charts namespace.

@using Syncfusion.Blazor.Charts

Adding SyncfusionBlazor service in Startup.cs

Open the Startup.cs file and add services required by Syncfusion components using services.AddSyncfusionBlazor() method. Add this method in the ConfigureServices function as follows.

using Syncfusion.Blazor;

namespace BlazorApplication
{
public class Startup
{
    ....
    ....
    public void ConfigureServices(IServiceCollection services)
    {
        ....
        ....
        services.AddSyncfusionBlazor();
    }
}
}

To enable custom client-side source loading from CRG or CDN, please refer to the section about custom resources in Blazor application.

Adding Range Navigator component

To initialize the Range Navigator component, add the below code to your Index.razor view page under ~/Pages folder. In a new application, if Index.razor page has any default content template, then those content can be completely removed and following code can be added.

@page "/"

<SfRangeNavigator>

</SfRangeNavigator>

Populate Range Navigator with Data

To bind data for the Range Navigator component, you can assign a IEnumerable object to the DataSource property. It can also be provided as an instance of the DataManager.

@code {
public class StockPrice
{
    public DateTime Date { get; set; }
    public double Close { get; set; }
}
public List<StockPrice> StockDetails = new List<StockPrice>
{
    new StockPrice { Date = new DateTime(2005, 01, 01), Close = 21 },
    new StockPrice { Date = new DateTime(2006, 01, 01), Close = 24 },
    new StockPrice { Date = new DateTime(2007, 01, 01), Close = 36 },
    new StockPrice { Date = new DateTime(2008, 01, 01), Close = 38 },
    new StockPrice { Date = new DateTime(2009, 01, 01), Close = 54 },
    new StockPrice { Date = new DateTime(2010, 01, 01), Close = 57 },
    new StockPrice { Date = new DateTime(2011, 01, 01), Close = 62 }
};
}

Now map Date and Close fields from the datasource to XName and YName properties of the RangeNavigatorSeries and then set the StockDetails to DataSource property.

<SfRangeNavigator ValueType="RangeValueType.DateTime" IntervalType="RangeIntervalType.Years" LabelFormat="yyyy">
<RangeNavigatorSeriesCollection>
    <RangeNavigatorSeries DataSource="@StockDetails" XName="Date" Type="RangeNavigatorType.Area" YName="Close"></RangeNavigatorSeries>
</RangeNavigatorSeriesCollection>
</SfRangeNavigator>

On successful compilation of your application, the Syncfusion Blazor Range Navigator component will render in the web browser as shown below.

range navigator