Showing and Formatting Data Text Labels

"series":[
{"series": s,
   "dataLabels": {
       "visible": boolean,
       "content": "string",  
       "content": function(),
       "position": "string",  
       "font": "string",
       "color": "string",
       "useNegativeColor": boolean,
       "negativeColor": "string",
       "numberFormat": "numformat",
       "feelerLine": {
          "visible": boolean,
          "width": number,
          "color": "string",
          "dash": "string"
   }
}
} ...
]

where:

s

Is a series identifier, either a number, 'all', or 'reset'.

"visible": boolean

Can be:

• true, which makes the data text labels visible. When visible is true, use the series-specific showDataValues property to hide data labels for individual series.
• false, which makes the data text labels not visible. This is the default value.
• "auto", which lets the chart engine determine whether the data labels are visible.

"content": "string"

Controls the data text to show. Valid values are "x", "y", "z", "%", "%+", "cumulative", "groupLabel", or "seriesLabel". For Leaflet choropleth map charts, "name" can be used to display location names. The default value is "x".

• For a bubble chart, use "x", "y", or "z" to identify which value to show (x-Position, y-Position, or Size (z)).
• For a line chart where the data set includes marker size values, use "x" or "y" to show the y-axis value. Use "z" to show the marker size values.
• For a scatter chart, use "x" or "y" to identify which value to show (x-Position, y-Position).
• For a pie chart, use "%" to show the percentage value of a pie slice (as a decimal) or "value" (the default for pie charts) to show the measure value for the slice.

  For % mode in pie charts, you must set the numberFormat property to display the value as a percentage (for example, "numberFormat": "[>9]#,#%;[<0]-#.#%;[<=9]#.##%;[=0]0"). For information on formatting numbers, see Formatting Numbers.

• For stacked bar, line, or area charts ("blaProperties": {"seriesLayout": "stacked"}), use "cumulative" to show the stack total, "%" to show the stack value as a percentage, or "%+" to show percentage and cumulative values.
• For a Leaflet choropleth map chart, use "name" to show the location names. For an example, see Map Support.
• You can also use the content property to define a function to display multiple values.

"content": function()

Identifies a function to call for each data label. The default value is undefined. This function can use up to four arguments (data value, series ID, group ID, and data object) and should return a string to be displayed. For more information on callback functions, see Defining a Callback Function to Display Values in Labels.

"position": "string"

Is a string that defines the position of data labels relative to the risers. Valid values are "bottom", "center", "insideBottom", "insideTop", "left", "outside", "right", "top", or "auto". The default value is "top".

• The "insideBottom" setting is for bar risers only and draws the data labels inside the bottom of the riser.
• The "insideTop" setting is for bar risers and pie slices only and draws the data labels inside the top edge of the riser or slice.
• For pie charts, the only valid settings are "center" (on pie slices), "insideTop", and "outside" (outside pie slices with feeler lines).
• For bar risers, positions are orientation aware (for example, "top" corresponds to "right" in a horizontal bar).
• For bullet charts, also see the series-specific marker position property that defines the position of the marker relative to data text.
• The "auto" setting lets the chart engine decide where to position the labels.

Note: Position On top edge is not supported in JSCHART format.

"font": "string"

Is a string that defines the size, style, and typeface of the data text labels. The default value is "font": "7.5pt Sans-Serif".

"color": "string"

Is a string that defines the color by name, numeric specification string, or gradient definition string, of the data text labels. The default value is "black".

"useNegativeColor": boolean

Controls whether to use a different color for data text labels for negative risers. Can be:

• true, which makes the data text labels for negative risers the color defined by the negativeColor property.
• false, which uses the same color for all data text labels. This is the default value.

"negativeColor": "string"

Is a string that defines the color for data text labels for negative risers by name, numeric specification string, or gradient definition string, of the data text labels. The default value is "red".

"numberFormat": "numformat"

Is the number format for the data labels. The number format can be specified as a JSON object, a format string, or a user-defined function. The default value is "auto". You can also use autoNumberFormats to apply a number format to all data text labels. For information on number formats, see Formatting Numbers.

"feelerLine":

Defines the properties of the feeler lines.

"visible": boolean

Valid values are:

• true, to make the feeler lines visible. This is the default value.
• false, to make the feeler lines not visible.

"width": number

Is a number of pixels that defines the width of the feeler lines. The default value is 1.

"color": "string"

Is a string that defines the color of the feeler lines, using a color name or numeric specification string. The default value is "black".

For information about specifying colors, see Colors and Gradients.

"dash": "string"

Is a string that defines the dash style. The default value is "", which produces a solid line. Use a string of numbers that defines the width of a dash followed by the width of the gap between dashes (for example, dash: "1 1" draws a dotted line).