|
Name
|
Type
|
Default
|
|
width
|
Number
|
350
|
Sets or gets the gauge's width. This property accepts size in pixels and percentage.
Initializing jqxGauge with the width property specified:
$('#gauge').jqxGauge({ width: 400 });
|
|
height
|
Number
|
350
|
Sets or gets the gauge's height. This property accepts size in pixels and percentage.
Initializing jqxGauge with the height property specified:
$('#gauge').jqxGauge({ height: 400 });
|
|
radius
|
Number
|
'50%'
|
Sets or gets gauge's radius. This property accepts size in pixels and percentage.
Initializing jqxGauge with the radius property specified:
$('#gauge').jqxGauge({ radius: 200 });
|
|
startAngle
|
Number
|
30
|
Sets or gets gauge's startAngle. This property specifies the beggining of the gauge's scale and is measured in degrees.
Initializing jqxGauge with the startAngle property specified:
$('#gauge').jqxGauge({ startAngle: 10 });
|
|
endAngle
|
Number
|
270
|
Sets or gets gauge's endAngle. This property specifies the end of the gauge's scale and is measured in degrees.
Initializing jqxGauge with the endAngle property specified:
$('#gauge').jqxGauge({ endAngle: 70 });
|
|
value
|
Number
|
0
|
Sets or gets gauge's value.
Initializing jqxGauge with the value property specified:
$('#gauge').jqxGauge({ value: 15 });
|
|
min
|
Number
|
0
|
Sets or gets gauge's minimum value.
Initializing jqxGauge with the min property specified:
$('#gauge').jqxGauge({ min: 10 });
|
|
max
|
Number
|
220
|
Sets or gets jqxGauge's max value.
Initializing jqxGauge with the max property specified:
$('#gauge').jqxGauge({ max: 200 });
|
|
colorScheme
|
String
|
'scheme01'
|
Sets the gauge's color pallete. jqxGauge suppports 11 color schemes from 'scheme01'
to 'scheme11'.
Initializing jqxGauge with the colorScheme property specified:
$('#gauge').jqxGauge({ colorScheme: 'scheme06' });
|
|
disabled
|
Boolean
|
false
|
Sets or gets whether the jqxGauge is disabled.
Initializing jqxGauge with the disabled property specified:
$('#gauge').jqxGauge({ disabled: true });
|
|
ticksDistance
|
Number
|
'20%"
|
Sets and gets the ticks position. This property can be specified using percents (between '0%' and '100%') or using pixels.
If the ticksRadius is '0%' this will position the ticks in the outer border of the gauge and if it's '100%' ticks will be positioned near the center
Initializing jqxGauge with the ticksRadius property specified:
$('#gauge').jqxGauge({ ticksDistance: '26%' });
|
|
animationDuration
|
Number
|
400
|
Sets or gets jqxGauge's animation duration [ms].
Initializing jqxGauge with the animationDuration property specified:
$('#gauge').jqxGauge({ animationDuration: 300 });
|
|
easing
|
String
|
linear
|
Sets or gets jqxGauge's animation easing.
Possible easings are: 'linear', 'easeOutBack', 'easeInQuad', 'easeInOutCirc', 'easeInOutSine', 'easeOutCubic'.
Initializing jqxGauge with the easing property specified:
$('#gauge').jqxGauge({ easing: 'easeOutCubic' });
|
|
showRanges
|
Boolean
|
true
|
This property indicates whether the gauge's ranges will be visible.
Initializing jqxGauge with the showRanges property specified:
$('#gauge').jqxGauge({ showRanges: false });
|
|
ranges
|
Array
|
[]
|
This property is array of objects. Each object is different range. The range is colored area with specified size.
Here is sample initialization of the jqxGauge with the ranges array:
var ranges = [{
startValue: 0,
endValue: 35,
startWidth: 1,
endWidth: 5,
startDistance: '5%',
endDistance: '5%',
style: {
fill: '#dddddd',
stroke: '#dddddd'
}
},
{
startValue: 35,
endValue: 55,
startWidth: 5,
endWidth: 10,
startDistance: '5%',
endDistance: '5%',
style: {
fill: '#dddddd',
stroke: '#dddddd'
}
}];
$('#gauge').jqxGauge({ ranges: ranges });
- startValue - the value from which the range will start
- endValue - the value where the current range will end
- startWidth - the width of the range in it's start
- endWidth - the end width of the range
- startDistance [optional]- this property is measured in pixels or percentage. It indicates the distance from the gauge's outer boundary to the start of the range.
- endDistance [optional]- this property is measured in pixels or percentage. It indicates the distance from the gauge's outer boundary to the end of the range.
- style - this property is object containing style information for the range. It accepts properties like 'fill', 'stroke', etc.
|
|
style
|
Object
|
{ fill: '#ffffff', stroke: '#ffffff' }
|
Gets or sets the gauge's style.
Here is sample initialization of the jqxGauge with style property specified:
$('#gauge').jqxGauge({ style: { fill: '#cccccc', stroke: '#cccccc' }});
In the upper code we are setting the jqxGauge to be with background color '#cccccc' and stroke '#cccccc'.
|
|
ticksMinor
|
Object
|
{ size: '10%', interval: 5, style: { stroke: '#898989'}, visible: true }
|
Gets or sets the gauge's properties for it's minor ticks.
Here is sample initialization of the jqxGauge with ticksMinor property specified:
$('#gauge').jqxGauge({ ticksMinor: { size: '5%', interval: 15, style: { stroke: '#898989'}, visible: true }});
- size - specifies the length of the tick. This property can be set in pixels or in percentage.
- interval - specifies the ticks frequency. With interval equals to 5 each fifth value of the gauge will have a minor tick.
- visible - indicates if the minor ticks will be visible.
- style - sets ticks style (color and thickness)
|
|
ticksMajor
|
Object
|
{ size: '10%', interval: 5, style: { stroke: '#898989'}, visible: true }
|
Gets or sets the gauge's properties for it's major ticks.
Here is sample initialization of the jqxGauge with ticksMajor property specified:
$('#gauge').jqxGauge({ ticksMajor: { size: '10px', interval: 15, style: { stroke: '#898989'}, visible: true }});
- size - specifies the length of the tick. This property is measured in pixels or percentage.
- interval - specifies the ticks frequency. With interval equals to 5 each fifth value of the gauge will have a major tick.
- visible - indicates if the major ticks will be visible.
- style - sets ticks style (color and thickness)
|
|
border
|
Object
|
{ size: '10%', style: { stroke: '#cccccc'}, visible: true, showGradient: true }
|
Gets or sets the gauge's properties for it's border.
Here is sample initialization of the jqxGauge with border property specified:
$('#gauge').jqxGauge({ border: { size: '11%', style: { stroke: '#898989'}, visible: true }});
- size - specifies the size of the border. Border's size can be set in percentage or in pixels.
- visible - indicates if the border will be visible.
- style - sets border style (color and thickness)
- showGradient - whether a gradient background will be used
|
|
caption
|
Object
|
{ value: '', position: 'bottom', offset: [0, 0], visible: true }
|
Gets or sets the gauge's properties for it's caption.
Here is sample initialization of the jqxGauge with caption property specified:
$('#gauge').jqxGauge({ caption: { value: 'jQWidgets', position: 'bottom', offset: [0, 10], visible: true }});
- value - specifies the text.
- position - specifies the caption position. There four different positions - top, bottom, left and right. You can customize the position using the offset property described bellow.
- offset - array with two number elements. The first one indicates the left offset and the second one the top offset.
- visible - indicates whether the caption will be visible.
|
|
cap
|
Object
|
{ size: '4%', style: { fill: 'theme-specific-color', stroke: 'theme-specific-color' } , visible: true }
|
Gets or sets the gauge's properties for it's cap.
Here is sample initialization of the jqxGauge with the cap property specified:
$('#gauge').jqxGauge({ cap: { size: '5%', style: { fill: '#ff0000', stroke: '#00ff00' } , visible: true }});
- size - specifies the gauge's size. This property can be set as percentage or in pixels.
- style - specifies the gauge's cap styles. Here you can set it's fill or stroke colors.
- visible - indicates whether the cap will be visible.
|
|
pointer
|
Object
|
{ pointerType: 'default', style: { fill: 'theme-specific-color', stroke: 'theme-specific-color' }, length: '70%', width: '2%', visible: true }
|
Gets or sets the gauge's properties for it's pointer.
Here is sample initialization of the jqxGauge with the pointer property specified:
$('#gauge').jqxGauge({ pointer: { pointerType: 'default', style: { fill: '#ff0000', stroke: '#ff0000' }, length: '80%', width: '3%', visible: true }});
- pointerType - specifies the pointer type. Possible values for this property are - 'default' and 'rectangle'. If it's value is 'default' the pointer will be arrow otherwise it'll be rectangle.
- style - specifies the gauge's pointer style. Here you can set it's fill or stroke color.
- width - specifies pointer's width. This property can be set in percents ('0%' - '100%') or in pixels.
- length - specifies pointer's length. This property can be set in percents ('0%' - '100%') or in pixels.
- visible - indicates whether the pointer will be visible.
|
|
labels
|
Object
|
{ distance: '38%', position: 'none', interval: 20, offset: [0, -10], visible: true, formatValue: function (value) {
return value;
}}
|
Gets or sets the gauge's properties for it's labels.
Here is sample initialization of the jqxGauge with the labels property specified:
$('#gauge').jqxGauge({ labels: { distance: '50px', position: 'inside', interval: 20, offset: [0, -10], visible: true, formatValue: function (value) {
return value;
}}
});
- distance - specifies the labels distance from the gauge's center. This value could be set in percents ('0%' - '100%') or using pixels. This property is with lower priority than the position property.
- position - specifies the gauge's labels position. Possible values for this property are 'inside', 'outside' and 'none' (if you want to use the distance property). If it's value is inside the labels are going to be shown inside the scale otherwise they will be shown outside. This property is with higher priority than the distance property.
- style - specifies the gauge's pointer style. Here you can set it's fill or stroke color.
- interval - specifies labels's frequency.
- offset - specifies labels's offset. This property is array with two elements. The first one is the left offset and the second one is the top offset.
- formatValue - callback used for formatting the label. This function accepts a single parameter which the user can format and return to the labels renderer.
- visible - indicates whether the labels will be visible.
|