React Axis Layouts

    All Ignite UI for React charts include options to configure many axis layout options such as location, gap, and overlap as well as having the ability to share axes and 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 Gap Example

    The xAxisGap property of the React charts, determines the amount of space between columns or bars of plotted series. This property accepts a numeric value between 0.0 and 1.0. The value represents a relative width of the gap out of the available number of pixels between the series. Setting this property to 0 would mean there is no gap rendered between the series, and setting it 1 would render the maximum available gap.

    The following example shows the average maximum temperature in Celsius in New York City's Central Park represented by a Column Chart with an xAxisGap initially set to 1, and so there will be a full category's width between the columns. There is a slider that allows you to configure the gap in this example so that you can see what the different values do.

    Axis Overlap Example

    The xAxisOverlap property of the React charts, allows setting the overlap of the rendered columns or bars of plotted series. This property accepts a numeric value between -1.0 and 1.0. The value represents a relative overlap out of the available number of pixels dedicated to each series. Setting this property to a negative value (down to -1.0) results in the categories being pushed away from each other, producing a gap between themselves. Conversely, setting this property to a positive value (up to 1.0) results in the categories overlapping each other. A value of 1 directs the chart to render the categories on top of each other.

    The following example shows a comparison of the highest grossing worldwide film franchises compared by the total world box office revenue of the franchise and the highest grossing movie in the series, represented by a Column Chart with an xAxisOverlap initially set to 1, and so the columns will completely overlap each other. There is a slider that allows you to configure the overlap in this example so that you can see what the different values do.

    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 IgrDataChart to share axis, add multiple axes of the same type, or even cross axis at specific values. The following examples show how to use these features.

    Axis Sharing Example

    You can share and add multiple axes in the same plot area of the React Data Chart. It a common scenario to use shareIgrTimeXAxis 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 the the React Data Chart, you can also 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.

    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. The sliders provided can help you to configure where the X and Y axis cross each other in this case.

    Additional Resources

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

    API Members

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