LinearGauge Overview

Telerik UI for ASP.NET Core Ninja image

The LinearGauge 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 LinearGauge TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI LinearGauge widget.

The LinearGauge represents values on a linear scale.

Initializing the LinearGauge

The following example demonstrates how to initialize the LinearGauge.

    @(Html.Kendo().LinearGauge()
        .Name("linearGauge") // The name of the LinearGauge is mandatory. It specifies the "id" attribute of the widget.
        .Scale(scale => scale
            .Min(0) // Set the min value of the LinearGauge.
            .Max(200) // Set the min value of the LinearGauge.
        )
        .Pointer(pointer => pointer
            .Value(10) // Set the value of the LinearGauge.
        )
    )
    <kendo-lineargauge name="gauge">
        <scale min="0" max="200">
        </scale>
        <lineargauge-pointers>
            <pointer value="10"></pointer>
        </lineargauge-pointers>
    </kendo-lineargauge>

Basic Configuration

The LinearGauge configuration options are passed as attributes.

    @(Html.Kendo().LinearGauge()
          .Name("gauge")
          .Pointer(pointer => pointer.Value(10))
          .Scale(scale => scale
              .MajorUnit(20)
              .MinorUnit(2)
              .Min(-40)
              .Max(60)
              .Ranges(ranges =>
              {
                  ranges.Add().From(-40).To(-20).Color("#2798df");
                  ranges.Add().From(30).To(45).Color("#ffc700");
                  ranges.Add().From(45).To(60).Color("#c20000");
              }
              )
          )
    )
    <kendo-lineargauge name="gauge">
        <lineargauge-pointers>
            <pointer value="10"></pointer>
        </lineargauge-pointers>
        <scale major-unit="20" minor-unit="2" min="-40" max="60">
            <lineargauge-scale-ranges>
                <range color="#2798df" from="-40" to="-20">
                </range>
                <range color="#ffc700" from="30" to="45">
                </range>
                <range color="#c20000" from="45" to="60">
                </range>
            </lineargauge-scale-ranges>
        </scale>
    </kendo-lineargauge>

Referencing Existing Instances

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

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

See Also

In this article