sliderMarker

Defines the options of the range selector slider markers.

Type:

Object

When moving a slider, its marker displays the currently selected scale value. Use the sliderMarker object to set the required options for the range selector slider markers. For instance, you can format the markers' text, change the text font, or make the markers invisible.

View Demo

Show Example:
jQuery

In this example, several options of the sliderMarker configuration object are changed.


                                    

                                    

color

Specifies the color of the slider markers.

Type:

String

Default Value: '#9B9B9B'

This option supports the following colors.

To set a custom color for the font used to display the slider markers' text, use the color property.

Show Example:
jQuery

In this example, the slider markers are colored in pink.


                                    

                                    

customizeText

Specifies a callback function that returns the text to be displayed by slider markers.

Type:

function

Function parameters:
scaleValue:

Object

Defines a scale value.

Object structure:
value:

Date

|

Number

Specifies the scale value that is currently selected.

valueText:

String

Specifies the currently selected scale value with applied formatting.

Return Value:

String

The text to be displayed by a slider marker.

Cannot be used in themes.

When implementing a callback function for this property, use the value displayed in a slider marker. This value can be accessed using the fields of the object that is passed as the function's parameter. Alternatively, you can use the this object within the function. This object has the same structure as the object passed as a parameter.

View Demo

Show Example:
jQuery

In this example, the slider markers' text is customized using the customizeText option.


                                    

                                    

font

Specifies font options for the text displayed by the range selector slider markers.

Type:

Object

Show Example:
jQuery

In this example, several font options of the slider markers are changed.


                                    

                                    

format

Formats a value before it is displayed in a slider marker.

Type:

Format

Default Value: undefined

See the format section for details on accepted values.

See Also
Show Example:
jQuery

In this example, the slider marker values are formatted in a 'fixedPoint' format with the precision of 2.


                                    

                                    

invalidRangeColor

Specifies the color used for the slider marker text when the currently selected range does not match the minRange and maxRange values.

Type:

String

Default Value: 'red'

Show Example:
jQuery

In this example, if you try to select a range less than 10 and greater than 20, the slider markers will be colored in 'darkred'.


                                    

                                    

padding

Deprecated

Use the paddingLeftRight option instead.

Specifies the empty space between the marker's border and the marker’s text.

Type:

Number

Default Value: 6

Show Example:
jQuery

In this example, the slider marker's padding option is set to 30.


                                    

                                    

paddingLeftRight

Specifies the empty space between the marker's left and right borders and the marker's text.

Type:

Number

Default Value: 4

Show Example:
jQuery

Move the slider at the bottom to change the slider marker's paddingLeftRight value.


                                    

                                    

paddingTopBottom

Specifies the empty space between the marker's top and bottom borders and the marker's text.

Type:

Number

Default Value: 2

Show Example:
jQuery

Move the slider at the bottom to change the slider marker's paddingTopBottom value.


                                    

                                    

placeholderHeight

Specifies the placeholder height of the slider marker.

Type:

Number

Default Value: undefined
Cannot be used in themes.

Show Example:
jQuery

Consider two horizontally aligned range selectors with the different height of the slider markers. Due to this difference, the chart displayed on the background of both range selectors is scaled differently. To avoid inconsistent data presentation caused by the slider marker, set the marker's placeholderHeight option to the same value. Use the checkbox at the bottom of range selectors to do it.


                                    

                                    

placeholderSize

Deprecated

Use the placeholderHeight option instead.

Specifies in pixels the height and width of the space reserved for the range selector slider markers.

Type:

Number

|

Object

Default Value: undefined

You can set a numeric value to this property. This value will be used as a width and height of both the left and right slider markers. You can also set individual values for a width and height, and make them similar or different for the left and right slider markers. To do this, specify placeholderSize as an object. When setting this object's properties, take into account the font size of the text displayed in the slider markers.

You may need to set this property, when you need to know the exact size of the RangeSelector widget elements in vertical and horizontal directions. For instance, this may be required when displaying an image in the background in a stretched mode. To get the background height, subtract the scale's placeholder height and the slider markers' placeholder height from the RangeSelector's height. To get the background width, subtract the placeholder widths of slider markers from the RangeSelector's width.

precision

Deprecated

Use the sliderMarker.format.precision option instead.

Specifies a precision for the formatted value displayed in slider markers.

Type:

Number

Default Value: undefined

visible

Indicates whether or not the slider markers are visible.

Type:

Boolean

Default Value: true

Show Example:
jQuery

Toggle the check box below to change the visibility of the slider markers.