Introduction
Licensing
Knowledge Base
Components / Charts / Overview

ASP.NET Core Chart Overview

The Telerik UI Chart TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI Chart widget. To add the component to your ASP.NET Core app, you can use either.

The Chart uses modern browser technologies to render high-quality data visualizations. All graphics are rendered on the client by using Scalable Vector Graphics (SVG) with a fallback to Canvas. The Charts support a set of series types such as Bar, Line, Area, Bullet, Pie, Scatter, Bubble, Polar, and others.

ninja-iconNew to Telerik UI for ASP.NET Core?Telerik UI for ASP.NET Core is a professional grade UI library with 110+ components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.Start Free Trial

The following image displays the structure of the Chart.

UI for ASP.NET Core Chart Structure

To see the component in action, check the examples:

Initializing the Chart

The following example demonstrates how to define the Chart.

Razor
   @(Html.Kendo().Chart(Model)
      .Name("internetUsersChart") // The name of the Chart is mandatory. It specifies the "id" attribute of the widget.
      .Title("Internet Users")
      .Series(series => {
          series.Bar(model => model.Value) // Create a Bar Chart series bound to the "Value" property.
                .Name("United States");
      })
      .CategoryAxis(axis => axis
          .Categories(model => model.Year)
      )
    )

The Chart contains the following building block elements:

ElementDescription
TitleThe Chart provides extensive configuration options for its title. See the client-side properties for the Title of the Chart component.
LegendThe Chart provides extensive configuration options for its legend. See the client-side properties for the Legend of the Chart.
Chart areaThe chart area represents the entire visible area of the Chart. See the client-side properties for the Chart Area of the Chart component.
Plot AreaThe plot area displays the series in the Chart. See the client-side properties for the Plot Area of the Chart component.
Axis defaultsThe Chart provides default options that are valid for all Chart axes. This element accepts the options supported by categoryAxis, valueAxis, xAxis, and yAxis.
SeriesThe Chart provides various configuration options for its series. The series type is determined by the value of the type field. If a type value is missing, the type is assumed to be the one specified in seriesDefaults.

Basic Configuration

To configure the Chart, pass the configuration options as attributes:

Razor
@(Html.Kendo().Chart()
    .Name("chart")
    .Title("Gross domestic product growth /GDP annual %/")
    .Legend(legend => legend
        .Position(ChartLegendPosition.Top)
    )
    .ChartArea(chartArea => chartArea
        .Background("transparent")
    )
    .Series(series =>
    {
        series.Column(new double[] { 3.907, 7.943, 7.848, 9.284, 9.263, 9.801, 3.890, 8.238, 9.552, 6.855 }).Name("India");
        series.Column(new double[] { 4.743, 7.295, 7.175, 6.376, 8.153, 8.535, 5.247, -7.832, 4.3, 4.3 }).Name("Russian Federation");
        series.Column(new double[] { 0.010, -0.375, 1.161, 0.684, 3.7, 3.269, 1.083, -5.127, 3.690, 2.995 }).Name("Germany");
        series.Column(new double[] { 1.988, 2.733, 3.994, 3.464, 4.001, 3.939, 1.333, -2.245, 4.339, 2.727 }).Name("World");
    })
    .CategoryAxis(axis => axis
        .Name("series-axis")
        .Line(line => line.Visible(false))
    )
    .CategoryAxis(axis => axis
        .Name("label-axis")
        .Categories("2002", "2003", "2004", "2005", "2006", "2007", "2008", "2009", "2010", "2011")
    )
    .ValueAxis(axis => axis
        .Numeric()
            .Labels(labels => labels.Format("{0}%"))

            // Move the label-axis all the way down the value axis.
            .AxisCrossingValue(0, int.MinValue)
    )
    .Tooltip(tooltip => tooltip
        .Visible(true)
        .Format("{0}%")
        .Template("#= series.name #: #= value #")
    )
)

Axis Title

You can also add a title to clearly indicate the role of the axis.

Razor
    @(Html.Kendo().Chart()
        .Name("chart")
        .Title("Average temperature and humidity")
        .Legend(legend => legend
            .Position(ChartLegendPosition.Bottom)
        )
        .Series(series => {
            series.Column(new double[] { 20, 25, 32 }).Name("Temperature").Axis("temperature");
            series.Column(new double[] { 45, 50, 80 }).Name("Humidity").Axis("humidity");
        })
        .CategoryAxis(axis => axis
            .Categories("Aug", "Sep", "Oct")
            .AxisCrossingValue(0, 3)
        )
        .ValueAxis(axis => axis
            .Numeric()
            .Name("temperature")
            .Title(t=>t.Text("Temperature, Celsius"))
        )
        .ValueAxis(axis => axis
            .Numeric()
            .Name("humidity")
            .Title(t=>t.Text("Relative Humidity"))
        )
    )

UI for ASP.NET Core Chart with axis titles

Plot Bands

The Chart enables you to configure each axis to display bands with different colors for predefined value ranges. The category index (zero-based) is used as a value for the category axis.

Razor
    .ValueAxis(axis => axis.Numeric()
        .Labels(labels => labels.Format("{0:N0}"))
        .MajorUnit(10000)
        .Max(70000)
        .Line(line => line.Visible(false))
        .PlotBands(bands => {
            bands.Add().From(10000).To(30000).Color("#c00").Opacity(0.3);
            bands.Add().From(30000).To(30500).Color("#c00").Opacity(0.8);
        })
    )

UI for ASP.NET Core Chart with axis plot bands

Global Settings

You may also need to apply global settings that affect all axes. In such cases, use AxisDefaults.

Razor
    .AxisDefaults(a=> a
        .Labels(l=>l.Font("16px Verdana"))
    )

Functionality and Features

  • Data binding—You can populate the Telerik UI Chart for ASP.NET Core with data by binding it to inline data, local data, or remote data.
  • Appearance—Unlike other Telerik UI for ASP.NET Core components which use only CSS for styling, you can control the appearance of the Chart elements primarily by using JavaScript style options.
  • No Data Template—The Chart for ASP.NET Core allows you to display a message when there is no data to show. Here’s how to set up a custom message for scenarios where the chart data is unavailable.
  • Series Patterns—The Telerik UI Chart component for ASP.NET Core offers customization options for presenting data visually, including support for using patterns in chart series.

Chart Types

The Telerik UI for ASP.NET Core Chart supports an extensive set of series types.

Chart typeDescription
Categorical ChartsCategorical Charts use a single category axis and a single value axis.
Scatter ChartsScatter Charts display data as points that are defined by the values of their items.
Area ChartsArea Charts display quantitative data by using continuous lines that pass through points defined by the values of their items.
Bar ChartsBar Charts display data using horizontal or vertical bars whose length varies according to their values.
Box Plot ChartsBox Plot Charts are useful for displaying variations in statistical samples of data and data details in a small space.
Bubble ChartsBubble Charts display data as points with coordinates and sizes determined by the values of their items.
Bullet ChartsBullet Charts represent a variation of the Bar Chart.
Funnel ChartsFunnel Charts are suitable for representing stages in a sales process and for showing the amount of the potential revenue from each stage.
Line ChartsLine Charts are suitable for displaying quantitative data by using continuous lines passing through points defined by the values of their items.
Pie ChartsPie Charts display data as single-series sectors from a two-dimensional circle which is useful for rendering data as a part of the whole.
Polar ChartsPolar Charts represent the relationships between data points in terms of radiuses and angles in a circular coordinate system.
Donut ChartsDonut Charts are a Pie chart variation with the ability to display data as single-series sectors from a two-dimensional circle.
StockChartStockCharts visualize the price movement of any financial instrument over a certain period.

Referencing Existing Instances

To reference an existing Chart instance, use the jQuery.data() configuration option. Once a reference is established, use the Chart client-side API to control its behavior.

Razor
    // Place the following after the Chart for ASP.NET Core declaration.
    <script>
        $(function() {
            // The Name() of the Chart is used to get its client-side instance.
            var chart = $("#internetUsersChart").data("kendoChart");
        });
    </script>

Next Steps

See Also

In this article
Initializing the ChartBasic ConfigurationAxis TitlePlot BandsGlobal SettingsFunctionality and FeaturesChart TypesReferencing Existing InstancesNext StepsSee Also
Not finding the help you need?
Contact Support