Web Components Axis Layouts

    All Ignite UI for Web Components charts include options to configure many axis layout options such as location as well as having the ability to share axis between series or have multiple axes in the same chart. These features are demonstrated in the examples given below.

    [!Note] the following examples can be applied to IgcCategoryChartComponent as well as IgcFinancialChartComponent controls.

    Axis Locations Example

    For all axes, you can specify axis location in relationship to chart plot area. The xAxisLabelLocation property of the Web Components charts, allows you to position x-axis line and its labels on above or below plot area. Similarly, you can use the yAxisLabelLocation property to position y-axis on left side or right side of plot area.

    The following example depicts the amount of renewable electricity produced since 2009, represented by a Line Chart. There is a drop-down that lets you configure the yAxisLabelLocation so that you can visualize what the axes look like when the labels are placed on the left or right side on the inside or outside of the chart's plot area.

    Axis Advanced Scenarios

    For more advanced axis layout scenarios, you can use Web Components Data Chart to share axis, add multiple y-axis and/or x-axis in the same plot area, or even cross axes at specific values. The following examples show how to use these features of the IgcDataChartComponent.

    Axis Sharing Example

    You can share and add multiple axes in the same plot area of the Web Components IgcDataChartComponent. It a common scenario to use share IgcTimeXAxisComponent and add multiple IgcNumericYAxisComponent to plot many data sources that have wide range of values (e.g. stock prices and stock trade volumes).

    The following example depicts a stock price and trade volume chart with a Stock Chart and a Column Chart plotted. In this case, the Y-Axis on the left is used by the Column Chart and the Y-Axis on the right is used by the Stock Chart, while the X-Axis is shared between the two.

    Axis Crossing Example

    In addition to placing axes outside plot area, the Web Components IgcDataChartComponent also provides options to position axes inside of plot area and make them cross at specific values. For example, you can create trigonometric chart by setting crossingAxis and crossingValue properties on both x-axis and y-axis to render axis lines and axis labels such that they are crossing at (0, 0) origin point.

    The following example shows a Sin and Cos wave represented by a Scatter Spline Chart with the X and Y axes crossing each other at the (0, 0) origin point.

    Additional Resources

    You can find more information about related chart features in these topics:

    API References

    The following is a list of API members mentioned in the above sections: d in the above sections:

    IgcDataChartComponent IgcCategoryChartComponent
    AxesIgcNumericYAxisComponentcrossingAxis None
    AxesIgcNumericYAxisComponentcrossingValue None
    AxesIgcNumericXAxisComponentisInverted xAxisInverted
    AxesIgcNumericYAxisComponentisInverted yAxisInverted
    AxesIgcNumericYAxisComponentLabelLocation yAxisLabelLocation
    AxesIgcNumericXAxisComponentLabelLocation xAxisLabelLocation
    AxesIgcNumericYAxisComponentLabelHorizontalAlignment yAxisLabelHorizontalAlignment
    AxesIgcNumericXAxisComponentLabelVerticalAlignment xAxisLabelVerticalAlignment
    AxesIgcNumericYAxisComponentLabelVisibility yAxisLabelVisibility
    AxesIgcNumericXAxisComponentLabelVisibility xAxisLabelVisibility