LinearGauge Overview
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>