React Axis Layouts

    All Ignite UI for React 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 IgrCategoryChart as well as IgrFinancialChart controls.

    Axis Locations Example

    For all axes, you can specify axis location in relationship to chart plot area. The xAxisLabelLocation property of the React 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 React 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 IgrDataChart.

    Axis Sharing Example

    You can share and add multiple axes in the same plot area of the React IgrDataChart. It a common scenario to use share IgrTimeXAxis and add multiple IgrNumericYAxis 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 React IgrDataChart 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:

    IgrDataChart IgrCategoryChart
    Axes ➔ IgrNumericYAxis ➔ crossingAxis None
    Axes ➔ IgrNumericYAxis ➔ crossingValue None
    Axes ➔ IgrNumericXAxis ➔ isInverted xAxisInverted
    Axes ➔ IgrNumericYAxis ➔ isInverted yAxisInverted
    Axes ➔ IgrNumericYAxis ➔ LabelLocation yAxisLabelLocation
    Axes ➔ IgrNumericXAxis ➔ LabelLocation xAxisLabelLocation
    Axes ➔ IgrNumericYAxis ➔ LabelHorizontalAlignment yAxisLabelHorizontalAlignment
    Axes ➔ IgrNumericXAxis ➔ LabelVerticalAlignment xAxisLabelVerticalAlignment
    Axes ➔ IgrNumericYAxis ➔ LabelVisibility yAxisLabelVisibility
    Axes ➔ IgrNumericXAxis ➔ LabelVisibility xAxisLabelVisibility