valueIndicator

Specifies the appearance options of the value indicator.

Type:

Object

The value indicator is a pointer which designates the main value of the gauge. There are several types of value indicators. Set the required one by using the type option, and then specify the options that are specific to this type, if needed. To learn the options that can be specified for a particular type, refer to one of the following sections.

View Demo

Show Example:
jQuery

In this example, several options of the valueIndicator configuration object are changed. Here, the gauge value is indicated by a two-color needle. The appearance of this needle is customized using the color, secondColor and width options. In addition, the look of the spindle is altered using the spindleSize and spindleGapSize options.


                                    

                                    

arrowLength

Specifies the length of an arrow for the indicator of the textCloud type in pixels.

Type:

Number

Default Value: 5
This member is exposed by the following entities:

backgroundColor

Specifies the background color for the indicator of the rangeBar type.

Type:

String

Default Value: 'none'
This member is exposed by the following entities:

baseValue

Specifies the base value for the indicator of the rangeBar type.

Type:

Number

Default Value: undefined
This member is exposed by the following entities:
Cannot be used in themes.

By default, a range bar starts from the beginning of the gauge scale. If you need to draw the range bar starting from a specific scale value, assign the required value to the baseValue option. In this instance, the range bar will display the range from the baseValue to the main gauge value.

View Demo

beginAdaptingAtRadius

Specifies a radius small enough for the indicator to begin adapting.

Type:

Number

Default Value: 50
This member is exposed by the following entities:

When adapting, the indicator adjusts its parts and surroundings proportionally to the changing widget size. The adjustments affect the incidator's indent from the center, the offset from the scale, and the spindle's size and gap.

color

Specifies a color of the indicator.

Type:

String

horizontalOrientation

Specifies the orientation of the rangeBar indicator. Applies only if the geometry.orientation option is "vertical".

Type:

String

Default Value: 'right' (value indicators), 'left' (subvalue indicators)
Accepted Values: 'left' | 'right'
This member is exposed by the following entities:

This option specifies the orientation of the indicator relative to an invisible scale line.

When using the widget as an ASP.NET MVC Control, specify this option using the HorizontalEdge enum. This enum accepts the following values: Left and Right.

indentFromCenter

Specifies the distance between the needle and the center of a gauge for the indicator of a needle-like type.

Type:

Number

Default Value: 0
This member is exposed by the following entities:

length

Specifies the indicator length.

Type:

Number

Default Value: 15
This member is exposed by the following entities:

offset

Specifies the distance between the indicator and the invisible scale line.

Type:

Number

palette

Sets the array of colors to be used for coloring subvalue indicators.

Type:

Array<String>

|

String

Default Value: 'Default'
Accepted Values: 'Default' | 'Soft Pastel' | 'Harmony Light' | 'Pastel' | 'Bright' | 'Soft' | 'Ocean' | 'Vintage' | 'Violet' | 'Carmine' | 'Dark Moon' | 'Soft Blue' | 'Dark Violet' | 'Green Mist'

Use this option to color subvalue indicators. If the number of colors in the specified array is less than the number of subvalue indicators, the colors are repeated, but slightly modified.

If you need to draw all subvalue indicators in one color, specify the subvalueIndicator.color option.

When using the widget as an ASP.NET MVC Control, you can specify this option using the VizPalette enum. This enum accepts the following values: Default, SoftPastel, HarmonyLight, Pastel, Bright, Soft, Ocean, Vintage, Violet, Carmine, DarkMoon, SoftBlue, DarkViolet and GreenMist.

secondColor

Specifies the second color for the indicator of the twoColorNeedle type.

Type:

String

Default Value: '#E18E92'
This member is exposed by the following entities:

When you use a twoColorNeedle indicator, define the colors for it using the color and secondColor options. The color option sets the color for the base of the needle. The secondColor option sets the color for the tip of the needle.

In addition, you can specify the ratio between the main and the second color using the secondFraction option.

secondFraction

Specifies the length of a twoNeedleColor type indicator tip as a percentage.

Type:

Number

Default Value: 0.4
This member is exposed by the following entities:

size

Specifies the range bar size for an indicator of the rangeBar type.

Type:

Number

Default Value: 10
This member is exposed by the following entities:

spindleGapSize

Specifies the inner diameter in pixels, so that the spindle has the shape of a ring.

Type:

Number

Default Value: 10
This member is exposed by the following entities:

Set this property to 0 so that the spindle has the shape of a circle.

spindleSize

Specifies the spindle's diameter in pixels for the indicator of a needle-like type.

Type:

Number

Default Value: 14
This member is exposed by the following entities:

text

Specifies the appearance of the text displayed in an indicator of the rangeBar type.

Type:

Object

This member is exposed by the following entities:

Note that the indent option of the text configuration object must not be set to 0 if you need to show the text.

type

Specifies the value indicator type.

Type:

String

Default Value: 'rectangleNeedle'
Accepted Values: 'rectangleNeedle' | 'triangleNeedle' | 'twoColorNeedle' | 'rangeBar' | 'triangleMarker' | 'textCloud'

Different options of the valueIndicator configuration object can be set for different types of the value indicator. These options are listed within the Indicator Types section.

When using the widget as an ASP.NET MVC Control, specify this option using the GaugeIndicatorType enum. This enum accepts the following values: RectangleNeedle, TriangleNeedle, TwoColorNeedle, RangeBar, TriangleMarker and TextCloud.

View Demo

Show Example:
jQuery

Use the drop-down menu below to change the type of the value indicator.


                                    

                                    

verticalOrientation

Specifies the orientation of the rangeBar indicator. Applies only if the geometry.orientation option is "horizontal".

Type:

String

Default Value: 'bottom' (value indicators), 'top' (subvalue indicators)
Accepted Values: 'bottom' | 'top'
This member is exposed by the following entities:

This option specifies the orientation of an indicator relative to an invisible scale line.

When using the widget as an ASP.NET MVC Control, specify this option using the VerticalEdge enum. This enum accepts the following values: Top and Bottom.

width

Specifies the width of an indicator in pixels.

Type:

Number

Default Value: 2
This member is exposed by the following entities: