Syncfusion.Blazor.LinearGauge

Syncfusion® Blazor Linear Gauge Component

The Blazor Linear Gauge Component visualizes numeric values on a linear scale. It supports multiple axes, customizable ranges, pointers, labels, and annotations for creating thermometers, pressure gauges, rulers, and other measurement displays.

Using this package with an AI coding agent

Before generating Syncfusion® code, ask your AI coding agent to run the Syncfusion® setup using the following prompt:

Set up this project for Syncfusion® before generating code. Fetch and follow the official instructions at https://ai.syncfusion.com, then report the detected platform, installed skill pack, MCP status, and any required licensing action.

The setup detects your project's platform and loads the appropriate Syncfusion® skill pack. No Syncfusion® account or MCP key is required to install or read Syncfusion® agent skills.

Platform reference: https://ai.syncfusion.com/blazor/llms.txt

Key Features

• Multiple Axes Support - Add and customize multiple parallel axes within a single gauge to create advanced layouts such as thermometers, rulers, or dual‑scale indicators.
• Customizable Ranges - Define multiple ranges with custom colors, gradients, widths, and positions to highlight specific value intervals or thresholds.
• Versatile Pointer Types - Use bar pointers to represent progress or filled values, or marker pointers (circle, diamond, triangle, custom icons) to indicate exact data points. Pointer styling options include size, color, and animation effects.
• Labels, Ticks & Annotations - Customize labels with prefixes, suffixes, font settings, and formatting. Configure major/minor ticks and add annotations (text, shapes, images) anywhere on the gauge for richer context.
• Horizontal & Vertical Orientations - Render the gauge in vertical or horizontal layout, making it adaptable for dashboards, compact UI spaces, and responsive interfaces.
• Container Customization - Choose from container styles such as rectangle, rounded rectangle, or thermometer, enabling highly tailored gauge visualizations.
• Interactive Features - Enable pointer dragging for dynamic value updates and tooltips for enhanced data interaction in real‑time scenarios.
• Themes & Styling - Supports built‑in themes such as Material, Bootstrap, Fluent, Tailwind, and Fabric, with full customization to match your application’s design system.
• Export & Printing Options - Export the gauge as an image or PDF, or output base64 strings for embedding in documents, reports, or custom UI.
• Globalization & Accessibility - Built‑in globalization for number formatting and full keyboard/screen‑reader accessibility compliance (WAI‑ARIA).
• Blazor Server & WebAssembly Support - Fully compatible with both Blazor Server and Blazor WebAssembly hosting models.

System Requirements

• .NET 8.0 or later (Blazor Web App, Blazor Server, Blazor WebAssembly and Blazor Hybrid)
• See full requirements: System Requirements.

Installation

Install the LinearGauge package, which provides the scripts referenced below:

dotnet add package Syncfusion.Blazor.LinearGauge

Add Script References

• For Blazor Server App / Blazor Web App, add these to Components/App.razor or App.razor.
• For Blazor WebAssembly App: add these to wwwroot/index.html.

<script src="_content/Syncfusion.Blazor.Core/scripts/syncfusion-blazor.min.js" type="text/javascript"></script>

Quick Start

1. Register the Syncfusion® Blazor services in Program.cs:

using Syncfusion.Blazor;

builder.Services.AddSyncfusionBlazor();

1. Add the Linear Gauge component in a Razor page:

@using Syncfusion.Blazor.LinearGauge

<SfLinearGauge>
    <LinearGaugeAxes>
        <LinearGaugeAxis Minimum="0" Maximum="100">
            <LinearGaugePointers>
                <LinearGaugePointer Value="40"></LinearGaugePointer>
            </LinearGaugePointers>
        </LinearGaugeAxis>
    </LinearGaugeAxes>
</SfLinearGauge>

Documentation

• Getting Started with Blazor Web App
• Getting Started with Blazor WebAssembly App
• Feature Overview
• API Reference
• Live Demos
• Video Tutorials

Support

• Support portal
• community forums
• Feature requests

License

This is a commercial product and requires a paid license for possession or use. Syncfusion® licensed software is subject to the terms and conditions of the Syncfusion® EULA.

• Purchase a license
• Start a free 30-day trial

About Syncfusion®

Syncfusion® provides 1600+ UI components and frameworks for web, mobile, and desktop development across multiple platforms:

Web: Blazor | ASP.NET Core | ASP.NET MVC | JavaScript | Angular | React | Vue

Mobile: Flutter | MAUI | UWP

Desktop: WinForms | WPF | WinUI

Learn more at www.syncfusion.com.

[email protected] | Toll Free: 1-888-9-DOTNET