Documentation

Getting Started

jqxBarGauge represents a jQuery bargauge widget that enables the user to select a date using a visual monthly bargauge display.
Every UI widget from jQWidgets toolkit needs its JavaScript files to be included in order to work properly.

The first step is to create html page and add links to the javascript files and css dependencies to your project. The jqxBarGauge widget requires the following files:

<link rel="stylesheet" href="../../jqwidgets/styles/jqx.base.css" type="text/css"/>
<script type="text/javascript" src="../../scripts/jquery-1.11.0.min.js"></script>
<script type="text/javascript" src="../../jqwidgets/jqxcore.js"></script>
<script type="text/javascript" src="../../jqwidgets/jqxdraw.js"></script>
<script type="text/javascript" src="../../jqwidgets/jqxbargauge.js"></script>

The next step is to create html element within the body of the html document.
<div id="barGauge"></div>

The last step is to initialize the widget by adding the following script to the html document:
$(document).ready(function()
{
// jqxBarGauge initialization code goes here.
}

To call a function(method), you need to pass the method name and parameters(if any) in the jqxBarGauge’s constructor.

$("#jqxGauge").jqxGauge('val', [14, 27, 35]);
    
To get the result of a function after calling it, you can use the following syntax:

var values = $("#jqxbargauge'").jqxBarGauge(‘val’);
    
To set a property(option), you need to pass the property name and value(s) in the jqxBarGauge's constructor.

$("#jqxbargauge").jqxBarGauge({ backgroundColor: 'red' });
    
To get a property(option), you need to pass the property name to the jqxBarGauge's constructor.

var backgroundColor = $("#jqxbargauge").jqxBarGauge('backgroundColor');
    
To bind to an event of a UI widget, you can use basic jQuery syntax. Let’s suppose that you want to get the selected date after the user clicks on a cell. The example code below demonstrates how to bind to the ‘valuechanged’ event of jqxBarGauge.

$('#jqxbargauge').on('valueChanged', function (event) {
});
    

Basic Sample

<!DOCTYPE html>
<html lang="en">
<head>
<meta name="keywords" content="jQuery BarGauge, BarGauge, Radial BarGauge, jqxBarGauge" />
<meta name="description" content="Bar Gauge default functionality." />
<title id='Description'>jqxBarGauge displays an indicator within a range of values. Gauges
can be used in a table or matrix to show the relative value of a field in a range
of values in the data region.</title>
<link rel="stylesheet" href="../../jqwidgets/styles/jqx.base.css" type="text/css" />
<script type="text/javascript" src="../../scripts/jquery-1.11.1.min.js"></script>
<script type="text/javascript" src="../../jqwidgets/jqxcore.js"></script>
<script type="text/javascript" src="../../jqwidgets/jqxdraw.js"></script>
<script type="text/javascript" src="../../jqwidgets/jqxbargauge.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
$('#barGauge').jqxBarGauge({
colorScheme: "scheme02", width: 600, height: 600,
values: [102, 115, 130, 137], max: 150, tooltip: {
visible: true, formatFunction: function (value)
{
var realVal = parseInt(value);
return ('Year: 2016<br/>Price Index:' + realVal);
},
}
});
});
</script>
<script async src="https://www.googletagmanager.com/gtag/js?id=G-2FX5PV9DNT"></script><script>window.dataLayer = window.dataLayer || [];function gtag(){dataLayer.push(arguments);}gtag('js', new Date());gtag('config', 'G-2FX5PV9DNT');</script></head>
<body>
<div id="barGauge"></div>
</body>
</html>

The result of the above code is: