@syncfusion/ej2-lineargauge
Version:
Essential JS 2 LinearGauge Components
78 lines (54 loc) • 8.41 kB
Markdown
# JavaScript Linear Gauge Control
The [JavaScript Linear Gauge](https://www.syncfusion.com/javascript-ui-controls/js-linear-gauge?utm_source=npm&utm_medium=listing&utm_campaign=javascript-lineargauge-npm) control is used to visualize numerical values of an axis in linear manner. All the linear gauge elements are rendered using Scalable Vector Graphics (SVG).
<p align="center">
<a href="https://ej2.syncfusion.com/documentation/linear-gauge/getting-started/?utm_source=npm&utm_medium=listing&utm_campaign=javascript-lineargauge-npm">Getting started</a> .
<a href="https://ej2.syncfusion.com/demos/?utm_source=npm&utm_medium=listing&utm_campaign=javascript-lineargauge-npm#/material/linear-gauge/default.html">Online demos</a> .
<a href="https://www.syncfusion.com/javascript-ui-controls/js-linear-gauge?utm_source=npm&utm_medium=listing&utm_campaign=javascript-lineargauge-npm">Learn more</a>
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/javascript/javascript-linear-gauge.png" alt="JavaScript Linear Gauge Control">
</p>
<p align="center">
Trusted by the world's leading companies
<a href="https://www.syncfusion.com">
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/syncfusion/syncfusion-trusted-companies.webp" alt="Bootstrap logo">
</a>
</p>
## Setup
To install the Linear Gauge and its dependent packages, use the following command,
```sh
npm install @syncfusion/ej2-lineargauge
```
## Supported frameworks
Linear Gauge control is also offered in the following list of frameworks.
| [<img src="https://ej2.syncfusion.com/github/images/angular-new.svg" height="50" />](https://www.syncfusion.com/angular-ui-components?utm_medium=listing&utm_source=github)<br/> [Angular](https://www.syncfusion.com/angular-ui-components?utm_medium=listing&utm_source=github) | [<img src="https://ej2.syncfusion.com/github/images/react.svg" height="50" />](https://www.syncfusion.com/react-ui-components?utm_medium=listing&utm_source=github)<br/> [React](https://www.syncfusion.com/react-ui-components?utm_medium=listing&utm_source=github) | [<img src="https://ej2.syncfusion.com/github/images/vue.svg" height="50" />](https://www.syncfusion.com/vue-ui-components?utm_medium=listing&utm_source=github)<br/> [Vue](https://www.syncfusion.com/vue-ui-components?utm_medium=listing&utm_source=github) | [<img src="https://ej2.syncfusion.com/github/images/netcore.svg" height="50" />](https://www.syncfusion.com/aspnet-core-ui-controls?utm_medium=listing&utm_source=github)<br/> [ASP.NET Core](https://www.syncfusion.com/aspnet-core-ui-controls?utm_medium=listing&utm_source=github) | [<img src="https://ej2.syncfusion.com/github/images/netmvc.svg" height="50" />](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_medium=listing&utm_source=github)<br/> [ASP.NET MVC](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_medium=listing&utm_source=github) |
| :-----: | :-----: | :-----: | :-----: | :-----: |
## Showcase samples
* CPU Utilization - [Live Demo](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-lineargauge-npm#/material/linear-gauge/annotation.html)
* Exercise Tracking - [Live Demo](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-lineargauge-npm#/material/linear-gauge/data.html)
## Key features
* [Axes](https://ej2.syncfusion.com/documentation/linear-gauge/axis/?utm_source=npm&utm_campaign=javascript-lineargauge-npm): Axes is a collection of axis that can be used to indicate the numeric values in linear scale.
* [Orientation](https://ej2.syncfusion.com/documentation/linear-gauge/axis/?utm_source=npm&utm_campaign=javascript-lineargauge-npm#orientation): Renders in both vertical and horizontal directions.
* [Container](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-lineargauge-npm#/material/linear-gauge/container.html): Container holds multiple axes together. It supports three types of containers: normal, rounded rectangle, and thermometer.
* [Ranges](https://ej2.syncfusion.com/documentation/linear-gauge/ranges/?utm_source=npm&utm_campaign=javascript-lineargauge-npm): Supports ranges to categorize the axis values. Any number of ranges can be added to the linear gauge.
* [Pointers](https://ej2.syncfusion.com/documentation/linear-gauge/pointers/?utm_source=npm&utm_campaign=javascript-lineargauge-npm): Pointers are used to indicate values on the axis. Linear gauge supports two types of pointers: bar and marker.
* [Annotation](https://ej2.syncfusion.com/documentation/linear-gauge/annotations/?utm_source=npm&utm_campaign=javascript-lineargauge-npm): Uses any custom HTML element as annotations and place it anywhere on the gauge.
* [Tooltip](https://ej2.syncfusion.com/documentation/linear-gauge/user-interaction/?utm_source=npm&utm_campaign=javascript-lineargauge-npm#tooltip): Provides information about the pointer values on hover.
* [Pointer drag](https://ej2.syncfusion.com/documentation/linear-gauge/user-interaction/?utm_source=npm&utm_campaign=javascript-lineargauge-npm#pointer-drag): Provides support to place the pointer at the desired values by dragging it.
* [Print and Export](https://ej2.syncfusion.com/documentation/linear-gauge/linear-gauge-print-and-export/?utm_source=npm&utm_campaign=javascript-lineargauge-npm): Prints or exports the rendered linear gauge to a desired format. Exporting supports four formats: PDF, PNG, JPEG and SVG.
* [Globalization](https://ej2.syncfusion.com/documentation/linear-gauge/internationalization/?utm_source=npm&utm_campaign=javascript-lineargauge-npm): Personalize the linear gauge control with different languages, as well as culture-specific number, date and time formatting.
* [Accessibility](https://ej2.syncfusion.com/documentation/linear-gauge/accessibility/?utm_source=npm&utm_campaign=javascript-lineargauge-npm): Provides with built-in accessibility support which helps to access all the linear gauge control features through the keyboard, screen readers, or other assistive technology devices.
## Support
Product support is available through the following mediums.
* [Support ticket](https://support.syncfusion.com/support/tickets/create) - Guaranteed Response in 24 hours | Unlimited tickets | Holiday support
* [Community forum](https://www.syncfusion.com/forums/essential-js2?utm_source=npm&utm_medium=listing&utm_campaign=javascript-lineargauge-npm)
* [GitHub issues](https://github.com/syncfusion/ej2-javascript-ui-controls/issues/new)
* [Request feature or report bug](https://www.syncfusion.com/feedback/javascript?utm_source=npm&utm_medium=listing&utm_campaign=javascript-lineargauge-npm)
* Live chat
## Changelog
Check the changelog [here](https://github.com/syncfusion/ej2-javascript-ui-controls/blob/master/controls/lineargauge/CHANGELOG.md?utm_source=npm&utm_campaign=javascript-lineargauge-npm). Get minor improvements and bug fixes every week to stay up to date with frequent updates.
## License and copyright
> This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this control, is subject to the terms and conditions of Syncfusion's [EULA](https://www.syncfusion.com/eula/es/). To acquire a license for 80+ [JavaScript UI controls](https://www.syncfusion.com/javascript-ui-controls), you can [purchase](https://www.syncfusion.com/sales/products) or [start a free 30-day trial](https://www.syncfusion.com/account/manage-trials/start-trials).
> A [free community license](https://www.syncfusion.com/products/communitylicense) is also available for companies and individuals whose organizations have less than $1 million USD in annual gross revenue and five or fewer developers.
See [LICENSE FILE](https://github.com/syncfusion/ej2-javascript-ui-controls/blob/master/controls/lineargauge/license?utm_source=npm&utm_campaign=javascript-lineargauge-npm) for more info.
© Copyright 2025 Syncfusion<sup>®</sup> Inc. All Rights Reserved. The Syncfusion<sup>®</sup> Essential Studio<sup>®</sup> license and copyright applies to this distribution.