text

Specifies the appearance of the text displayed in a subvalue indicator of the textCloud type.

Type: Object

Show Example:
jQuery

In this example, several text options of subvalue indicators are changed. These indicators display the text formatted in the fixedPoint format with a precision of 2. In addition, this text is colored in dodgerblue using the font color option.


                                    

                                    

customizeText

Specifies a callback function that returns the text to be displayed in a subvalue indicator of the textCloud type.

Type: function(indicatedSubvalue)
Function parameters:
indicatedSubvalue: Object
Defines an idicated subvalue.
Object structure:
value: Number
Specifies the scale value to be displayed in the subvalue indicator.
valueText: String
Specifies the scale value using an applied format, if the format and precision (optional) options are specified.
Return Value: String
The text to be displayed by a subvalue indicator.
Default Value: undefined

When implementing a callback function for this option, use the value displayed in a subvalue indicator. 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.

Show Example:
jQuery

In this example, the indicators of the textCloud type are used to display the gauge subvalues. The text within these indicators is customized using the customizeText option.


                                    

                                    

font

Specifies font options for the text displayed by a subvalue indicator of the textCloud type.

Type: Object

Show Example:
jQuery

In this example, several font options of the subvalue indicators are changed.


                                    

                                    

format

Specifies a format for the text displayed in a subvalue indicator of the textCloud type.

Type: String
Default Value: undefined
Accepted Values: 'currency' | 'fixedPoint' | 'percent' | 'decimal' | 'exponential' | 'largeNumber' | 'thousands' | 'millions' | 'billions' | 'trillions'

A textCloud subvalue indicator displays the scale value that it points to. You can apply formatting to the subvalue indicator text using one of the numeric formats.

NOTE: You can set a precision for subvalue indicator text using the precision option.

In addition to predefined formats, you can utilize format tokens from the Globalize JavaScript library to assign a custom format.

For details on formatting, refer to the Data Formatting topic.

Show Example:
jQuery

In this example, the indicators of the textcloud type are used to display the gauge subvalues. These subvalues are formatted in the currency format.


                                    

                                    

precision

Specifies a precision for the formatted value displayed in a subvalue indicator of the textCloud type.

Type: Number
Default Value: undefined

The value of the option must be an integer indicating the number of digits to show for the scale value displayed in a textCloud subvalue indicator.

This option is used when the subvalue indicator displays a scale value with an applied format. To learn how to set a format for the subvalue indicator text, refer to the format option description.

For general information on data formatting, refer to the Data Formatting topic.

Show Example:
jQuery

In this example, the indicators of the textCloud type are used to display gauge subvalues. These subvalues are formatted in the currency format with a precision of 1.