Version

Configuring Axis Labels (igShapeChart)

The igShapeChart control allows you full control over configuring, formatting and styling the labels displayed on your chart. By default, you do not need to explicitly set the labels. The Shape Chart will use the first appropriate string property that it finds within the data you provided and will use that for the labels.

In this topic

This topic contains the following sections:

Label Settings

In the igShapeChart control, you can change the rotation angle, margin, horizontal/vertical alignment, opacity, padding and visibility, of the x-axis and y-axis labels using the following properties:

Property Name Property Type Description
xAxisLabelAngle,
yAxisLabelAngle
number Determines angle rotation of x-axis or y-axis labels
xAxisLabelHorizontalAlignment,
yAxisLabelHorizontalAlignment
enumeration Determines horizontal alignment of the x-axis or y-axis labels
xAxisLabelVerticalAlignment,
yAxisLabelVerticalAlignment
enumeration Determines vertical alignment of the x-axis or y-axis labels
xAxisLabelLeftMargin,
yAxisLabelLeftMargin
number Determines the left margin applied to each x-axis or y-axis labels
xAxisLabelTopMargin,
yAxisLabelTopMargin
number Determines the top margin applied to each x-axis or y-axis labels
xAxisLabelRightMargin,
yAxisLabelRightMargin
number Determines the bottom margin applied to each x-axis or y-axis labels
xAxisLabelBottomMargin,
yAxisLabelBottomMargin
number Determines the bottom margin applied to each x-axis or y-axis labels

Styling

The look and feel of the shape chart’s x-axis and y-axis labels can be styled in many aspects, the main of which are applying different font styles such as font type, font size and font weight to the labels. This can be achieved through the following properties:

Property Name Property Type Description
xAxisLabelTextStyle,
yAxisLabelTextStyle
string Determines the text style for the x-axis or y-axis labels
xAxisLabelTextColor,
yAxisLabelTextColor
string Determines text color of the x-axis or y-axis labels
xAxisFormatLabel,
xAxisFormatLabel
object Gets or sets function which takes an context object and returns a formatted label for the x-axis or y-axis labels.

Code Snippet

The following code example shows how to style labels on the x-axis using style properties:

In HTML:

$(function () {
            $("#chart").igShapeChart({
                dataSource: data,
                xAxisLabelTextStyle: "16pt Verdana",
                xAxisLabelRightMargin: "14",
                xAxisLabelTextColor: "red"
            });
        });

The following screenshot demonstrates the igShapeChart control with the x-axis label styled.

Related Topics:

Samples

The following sample provides additional information related to this topic.

View on GitHub