JavaScript (ES5)

Search results

Getting started with JavaScript (ES5) Linear Gauge control

24 Jun 2022 / 4 minutes to read

This section explains you the steps to create a simple Linear Gauge and demonstrates the basic usage of the Linear Gauge component.

Control Initialization

The Essential JS 2 JavaScript controls can be initialized by using either of the following ways.

Using local script references in a HTML page.
Using CDN link for script reference.

Using local script references in a HTML page

Step 1: Create an app folder quickstart for getting started.

Step 2: You can get the global scripts from the Essential Studio JavaScript (Essential JS 2) build installed location.

Syntax:

Dependency Script: **(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\{DEPENDENCY_PACKAGE_NAME}\dist\global\{DEPENDENCY_PACKAGE_NAME}.min.js

Control Script: **(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\{PACKAGE_NAME}\dist\global\{PACKAGE_NAME}.min.js

Example:

Dependency Script: C:\Program Files (x86)\Syncfusion\Essential Studio\JavaScript - EJ2\20.1.0.58\Web (Essential JS 2)\JavaScript\ej2-base\dist\global\ej2-base.min.js

Control Script: C:\Program Files (x86)\Syncfusion\Essential Studio\JavaScript - EJ2\20.1.0.58\Web (Essential JS 2)\JavaScript\ej2-lineargauge\dist\global\ej2-lineargauge.min.js

The below located script file contains all Syncfusion JavaScript (ES5) UI control resources in a single file.

Scripts: **(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\ej2\dist\ej2.min.js

The Custom Resource Generator (CRG) is an online web tool, which can be used to generate the custom script for a set of specific controls. This web tool is used to combine the required control scripts in a single file.

Step 3: Create a folder ~/quickstart/resources and copy/paste the global scripts from the above installed location to ~/quickstart/resources/package corresponding package location.

Step 4: Create a HTML page (index.html) in ~/quickstart/index.html and add the Essentials JS 2 script references.

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>Essential JS 2</title>

    <!-- Essential JS 2 Base's global script (Dependency Script) -->
    <script src="resources/base/ej2-base.min.js" type="text/javascript"></script>
    <!-- Essential JS 2 lineargauge's global script (Control Script) -->
    <script src="resources/lineargauge/ej2-lineargauge.min.js" type="text/javascript"></script>
</head>
<body>
</body>
</html>

Step 5: Add the LinearGauge element and initiate the Syncfusion JavaScript (ES5) LinearGauge component in the ~/quickstart/index.html by using the following code.

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>Essential JS 2</title>

    <!-- Essential JS 2 Base's global script (Dependency Script) -->
    <script src="resources/base/ej2-base.min.js" type="text/javascript"></script>
    <!-- Essential JS 2 lineargauge's global script (Control Script) -->
    <script src="resources/lineargauge/ej2-lineargauge.min.js" type="text/javascript"></script>
</head>
<body>
    <!-- Add the HTML <lineargauge> element  -->
    <lineargauge id="element">Linear Gauge</lineargauge>
    <script>
        // initialize lineargauge control
        var lineargauge = new ej.lineargauge.LinearGauge();
        // Render initialized lineargauge.
        lineargauge.appendTo('#element');
    </script>
</body>
</html>

Step 6: Run the index.html in web browser, it will render the Syncfusion JavaScript Lineargauge control.

Using CDN link for script reference

Step 1: Create an app folder quickstart for getting started.

Step 2: The Essential JS 2 controls’ global scripts is already hosted in the below CDN link formats.

Syntax:

Dependency Script: https://cdn.syncfusion.com/ej2/20.1.58/{DEPENDENCY_PACKAGE_NAME}/dist/global/{PACKAGE_NAME}.min.js Control Script: https://cdn.syncfusion.com/ej2/20.1.58/{PACKAGE_NAME}/dist/global/{PACKAGE_NAME}.min.js

Example:

Script: https://cdn.syncfusion.com/ej2/20.1.58/ej2-lineargauge/dist/global/ej2-lineargauge.min.js

Step 3: Create a HTML page (index.html) in ~/quickstart/index.html location and add the CDN link references. Now, add the LinearGauge element and initiate the Syncfusion JavaScript (ES5) Linear Gauge control in the index.html by using following code.

The below example shows a basic linear gauge component.

Source

Preview

index.js

index.html

var lineargauge = new ej.lineargauge.LinearGauge();
lineargauge.appendTo('#element');

<!DOCTYPE html><html lang="en"><head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="Typescript UI Controls">
    <meta name="author" content="Syncfusion">
    <link href="index.css" rel="stylesheet">
    
    
<script src="https://cdn.syncfusion.com/ej2/20.1.58/dist/ej2.min.js" type="text/javascript"></script>
</head>

<body>
    
    <div id="container">
        <div id="element"></div>
    </div>


<script>
var ele = document.getElementById('container');
if(ele) {
    ele.style.visibility = "visible";
 }   
        </script>
<script src="index.js" type="text/javascript"></script>
</body></html>

Step 4: Now, run the index.html in web browser, it will render the Syncfusion JavaScript Linear Gauge control.

Adding the Linear Gauge Title

The title can be added to the Linear Gauge component using the title property in the Linear Gauge.

Source

Preview

index.js

index.html

ej.base.enableRipple(true);
var lineargauge = new ej.lineargauge.LinearGauge({
    title: 'linear gauge'
});
lineargauge.appendTo('#element');

<!DOCTYPE html><html lang="en"><head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="Typescript UI Controls">
    <meta name="author" content="Syncfusion">
    <link href="index.css" rel="stylesheet">
    
    
<script src="https://cdn.syncfusion.com/ej2/20.1.58/dist/ej2.min.js" type="text/javascript"></script>
</head>

<body>
    
    <div id="container">
        <div id="element"></div>
    </div>


<script>
var ele = document.getElementById('container');
if(ele) {
    ele.style.visibility = "visible";
 }   
        </script>
<script src="index.js" type="text/javascript"></script>
</body></html>

Setting the start and end of the axis line

The range of the axis can be set using the minimum and maximum properties in the Linear Gauge.

Source

Preview

index.js

index.html

ej.base.enableRipple(true);
var lineargauge = new ej.lineargauge.LinearGauge({
    axes: [{
        minimum: 0,
        maximum: 200
    }]
});
lineargauge.appendTo('#element');

<!DOCTYPE html><html lang="en"><head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="Typescript UI Controls">
    <meta name="author" content="Syncfusion">
    <link href="index.css" rel="stylesheet">
    
    
<script src="https://cdn.syncfusion.com/ej2/20.1.58/dist/ej2.min.js" type="text/javascript"></script>
</head>

<body>
    
    <div id="container">
        <div id="element"></div>
    </div>


<script>
var ele = document.getElementById('container');
if(ele) {
    ele.style.visibility = "visible";
 }   
        </script>
<script src="index.js" type="text/javascript"></script>
</body></html>

To denote the axis values with temperature units, add the °C as suffix to each label. This can be achieved by setting the {value}°C to the format property in the labelStyle object of the axis. Here, {value} acts as a placeholder for each axis label.

To change the pointer value from the default value of the gauge, set the value property in pointers object of the axis.

Source

Preview

index.js

index.html

var lineargauge = new ej.lineargauge.LinearGauge({
    axes: [{
        minimum: 0,
        maximum: 200,
        pointers: [{
            value: 140
        }],
        labelStyle: {
            format: '{value}°C'
        },
        ranges: [{
            start: 0,
            end: 80,
            startWidth:15,
            endWidth:15
        }, {
            start: 80,
            end: 120,
            startWidth:15,
            endWidth:15
        }, {
            start: 120,
            end: 140,
            startWidth:15,
            endWidth:15
        }, {
            start: 140,
            end: 200,
            startWidth:15,
            endWidth:15
        }]
    }]
});
lineargauge.appendTo('#element');

<!DOCTYPE html><html lang="en"><head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="Typescript UI Controls">
    <meta name="author" content="Syncfusion">
    <link href="index.css" rel="stylesheet">
    
    
<script src="https://cdn.syncfusion.com/ej2/20.1.58/dist/ej2.min.js" type="text/javascript"></script>
</head>

<body>
    
    <div id="container">
        <div id="element"></div>
    </div>


<script>
var ele = document.getElementById('container');
if(ele) {
    ele.style.visibility = "visible";
 }   
        </script>
<script src="index.js" type="text/javascript"></script>
</body></html>

Setting the value of the pointer

The pointer value is changed in the below sample using the value property in pointers object of the axis.

Source

Preview

index.js

index.html

ej.base.enableRipple(true);
var lineargauge = new ej.lineargauge.LinearGauge({
    axes: [{
        pointers:[{
            value: 40,
            color: 'green'
        }]
    }]
});
lineargauge.appendTo('#element');

<!DOCTYPE html><html lang="en"><head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="Typescript UI Controls">
    <meta name="author" content="Syncfusion">
    <link href="index.css" rel="stylesheet">
    
    
<script src="https://cdn.syncfusion.com/ej2/20.1.58/dist/ej2.min.js" type="text/javascript"></script>
</head>

<body>
    
    <div id="container">
        <div id="element"></div>
    </div>


<script>
var ele = document.getElementById('container');
if(ele) {
    ele.style.visibility = "visible";
 }   
        </script>
<script src="index.js" type="text/javascript"></script>
</body></html>

Contents

Control Initialization
Using local script references in a HTML page
Using CDN link for script reference
Adding the Linear Gauge Title
Setting the start and end of the axis line
Setting the value of the pointer

Contents

Control Initialization
Using local script references in a HTML page
Using CDN link for script reference
Adding the Linear Gauge Title
Setting the start and end of the axis line
Setting the value of the pointer