series.labels Object

Configures the series data labels.

series.labels.align String(default: "circle")

Defines the alignment of the labels.

Available for pie series.

"circle"

The labels are positioned in circle around the chart.

"column"

The labels are positioned in columns to the left and right of the chart.

series.labels.background String|Function

The background color of the labels.

series.labels.border Object

The border of the labels.

series.labels.border.color String|Function(default: "black")

The color of the border.

series.labels.border.dashType String|Function(default: "solid")

The dash type of the border.

"solid"

Specifies a solid line.

"dot"

Specifies a line consisting of dots.

"dash"

Specifies a line consisting of dashes.

"longDash"

Specifies a line consisting of a repeating pattern of long-dash.

"dashDot"

Specifies a line consisting of a repeating pattern of dash-dot.

"longDashDot"

Specifies a line consisting of a repeating pattern of long-dash-dot.

"longDashDotDot"

Specifies a line consisting of a repeating pattern of long-dash-dot-dot.

series.labels.border.width Number|Function(default: 0)

The width of the border.

series.labels.color String|Function

The text color of the labels.

series.labels.distance Number(default: 35)

The distance of the labels.

Available for pie series.

series.labels.font String|Function(default: "12px Arial,Helvetica,sans-serif")

The font style of the labels.

series.labels.format String|Function

The format of the labels.

Example

//sets format of the labels
format: "C"

series.labels.margin Number|Object(default: { left: 5, right: 5})

The margin of the labels.

Example

// sets the top, right, bottom and left margin to 3px.
margin: 3

// sets the top and bottom margin to 1px
// margin left and right are with 5px (by default)
margin: { top: 1, bottom: 1 }

series.labels.padding Number|Object(default: 0)

The padding of the labels.

Example

// sets the top, right, bottom and left padding to 3px.
padding: 3

// sets the top and left padding to 1px
// padding right and bottom are with 0px (by default)
padding: { top: 1, left: 1 }

series.labels.position String|Function(default: "above")

Defines the position of the labels.

"above"

The label is positioned at the top of the marker.

Applicable for area and line series.

"center"

The label is positioned at the point center.

Applicable for bar, column, pie series.

"insideEnd"

The label is positioned inside, near the end of the point.

Applicable for bar, column, pie series.

"insideBase"

The label is positioned inside, near the base of the bar.

Applicable for bar and column series.

"outsideEnd"

The label is positioned outside, near the end of the bar.

Applicable for bar, column, pie series. Not applicable for stacked series.

"right"

The label is positioned to the right of the marker.

Applicable for area and line series.

"below"

The label is positioned at the bottom of the marker.

Applicable for area and line series.

"left"

The label is positioned to the left of the marker.

Applicable for area and line series.

series.labels.template String | Function

The template which renders the chart series label.

The fields which can be used in the template are:

  • category - the category name. Available for area, bar, column, bubble, donut, line and pie series.
  • dataItem - the original data item used to construct the point. Will be null if binding to array.
  • percentage - the point value represented as a percentage value. Available only for donut, pie and 100% stacked charts.
  • series - the data series
  • value - the point value. Can be a number or object containing each bound field.

series.labels.visible Boolean|Function(default: false)

The visibility of the labels.

In this article