ASP.NET Core CircularGauge Overview

Telerik UI for ASP.NET Core Ninja image

The CircularGauge is part of Telerik UI for ASP.NET Core, 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.

The Telerik UI CircularGauge TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI CircularGauge widget.

The CircularGauge represents a value on a circular scale. It allows you to visualize numeric values in an attractive manner that matches the other widgets on the page.

It is essentially very similar to the ArcGauge with the difference that the CircularGauge is a complete circle. There are bigger differences with RadialGauge, however, since the Radial widget is focusing on displaying a value on a scale with the help of a pointer element. Also, setting range colors on the RadialGauge happens for the scale itself, while the color ranges for the CircularGauge happen for the value fill.

Initializing the CircularGauge

  1. Follow all the steps from the introductory article on Telerik UI for ASP.NET Core.

  2. Create a new action method which renders the view.

    public ActionResult Index()
        return View();
  3. Add the CircularGauge.

            .Name("circularGauge") // The name of the CircularGauge is mandatory. It specifies the "id" attribute of the widget.
            .Scale(x => x.Min(0).Max(100))
        <kendo-circulargauge name="circulargauge" value="65" center-template="#:value#%">
            <scale min="0" max="100">

Referencing Existing Instances

To reference an existing Telerik UI CircularGauge instance, use the configuration option. Once a reference is established, use the CircularGauge client-side API to control its behavior.

// Place the following after the Telerik UI CircularGauge for ASP.NET Core declaration.
    $(function() {
        // The Name() of the CircularGauge is used to get its client-side instance.
        var gauge = $("#circularGauge").data("kendoCircularGauge");


The CircularGauge supports different color ranges depending on the currently active value. The gauge will then colorize the value element and fill it with the respective range color:

     .Colors(colors =>
        <color from="0" to="25" color="#0058e9"/>
        <color from="25" to="50" color="#37b400"/>
        <color from="50" to="75" color="#ffc000"/>
        <color from="75" to="100" color="#f31700"/>

You can find a live sample demonstrating that here:

Color Ranges

Scale Options

There are various Scale Settings available so you can present the gauge exactly the way you want to:

    .Scale(x =>x.Labels(l=>l.Visible(true)))
        <labels visible="true"/>

You can change the start and end angle, the appearance of the label and ticks, min and max options of the scale, and others. For the full list of options, refer to the API reference of the CircularGauge.

See Also

In this article