The same data is rendered many to show the Axis Layout options in SciChart.js. Charts support outer, inner, central and stacked axes, and use of axis alignment to create vertical charts. Series may be registered on specific X,Y axis pairs for infinite layout configuration.
import { appTheme } from "./appTheme";
import {
EAutoRange,
EAxisAlignment,
EInnerAxisPlacementCoordinateMode,
ELabelAlignment,
FastLineRenderableSeries,
INumericAxisOptions,
NumberRange,
NumericAxis,
SciChartSurface,
XAxisDragModifier,
XyDataSeries,
YAxisDragModifier,
ZoomPanModifier,
RightAlignedOuterVerticallyStackedAxisLayoutStrategy,
} from "scichart";
export const drawExample = async (rootElement: string | HTMLDivElement) => {
const { sciChartSurface, wasmContext } = await SciChartSurface.create(rootElement, {
theme: appTheme.SciChartJsTheme,
});
const commonAxisOptions: INumericAxisOptions = {
drawMajorBands: false,
drawMajorGridLines: false,
drawMinorGridLines: false,
drawMajorTickLines: true,
autoRange: EAutoRange.Never,
axisTitleStyle: {
fontSize: 18,
},
majorTickLineStyle: {
tickSize: 6,
strokeThickness: 2,
color: "white",
},
axisBorder: {
border: 2,
color: "white",
},
labelStyle: {
fontSize: 14,
},
};
const horizontalAxisPosition = 60;
const verticalAxisPosition = 30;
const primaryColors = ["#4FBEE6", "#AD3D8D", "#6BBDAE", "#E76E63", "#2C4B92"];
const xAxis1 = new NumericAxis(wasmContext, { ...commonAxisOptions, id: "xAxis1", axisTitle: "X Axis" });
const xAxis2 = new NumericAxis(wasmContext, {
...commonAxisOptions,
id: "xAxis2",
axisTitle: "Flipped X Axis",
flippedCoordinates: true,
});
const xAxis3 = new NumericAxis(wasmContext, {
...commonAxisOptions,
id: "xAxis3",
axisTitle: "Stacked X Axis",
axisAlignment: EAxisAlignment.Right,
flippedCoordinates: false,
});
const xAxis4 = new NumericAxis(wasmContext, {
...commonAxisOptions,
id: "xAxis4",
// axisTitle: "TopInnerXAxis",
axisAlignment: EAxisAlignment.Top,
isInnerAxis: true,
});
const yAxis2 = new NumericAxis(wasmContext, { ...commonAxisOptions, id: "yAxis1", axisTitle: "Stacked Y Axis" });
const yAxis1 = new NumericAxis(wasmContext, {
...commonAxisOptions,
id: "yAxis2",
axisTitle: "Flipped Y Axis - Left Aligned",
axisAlignment: EAxisAlignment.Left,
flippedCoordinates: true,
});
const yAxis3 = new NumericAxis(wasmContext, {
...commonAxisOptions,
id: "yAxis3",
axisTitle: "Y Axis - Top Aligned",
axisAlignment: EAxisAlignment.Top,
flippedCoordinates: false,
});
const yAxis4 = new NumericAxis(wasmContext, {
...commonAxisOptions,
id: "yAxis4",
// axisTitle: "InnerYAxis",
flippedCoordinates: false,
isInnerAxis: true,
});
sciChartSurface.layoutManager.rightOuterAxesLayoutStrategy =
new RightAlignedOuterVerticallyStackedAxisLayoutStrategy();
// use axes with custom ids for positioning the central axes
sciChartSurface.layoutManager.rightInnerAxesLayoutStrategy.orthogonalAxisId = xAxis1.id;
sciChartSurface.layoutManager.bottomInnerAxesLayoutStrategy.orthogonalAxisId = yAxis1.id;
sciChartSurface.layoutManager.leftInnerAxesLayoutStrategy.orthogonalAxisId = xAxis1.id;
sciChartSurface.layoutManager.topInnerAxesLayoutStrategy.orthogonalAxisId = yAxis1.id;
sciChartSurface.layoutManager.rightInnerAxesLayoutStrategy.coordinateMode =
EInnerAxisPlacementCoordinateMode.DataValue;
sciChartSurface.layoutManager.rightInnerAxesLayoutStrategy.axisPosition = verticalAxisPosition;
sciChartSurface.layoutManager.topInnerAxesLayoutStrategy.coordinateMode =
EInnerAxisPlacementCoordinateMode.DataValue;
sciChartSurface.layoutManager.topInnerAxesLayoutStrategy.axisPosition = horizontalAxisPosition;
xAxis1.drawMajorGridLines = true;
yAxis1.drawMajorGridLines = true;
sciChartSurface.xAxes.add(xAxis2, xAxis3, xAxis1, xAxis4);
sciChartSurface.yAxes.add(yAxis2, yAxis3, yAxis1, yAxis4);
xAxis1.isPrimaryAxis = true;
yAxis1.isPrimaryAxis = true;
sciChartSurface.xAxes.asArray().forEach((xAxis, index) => {
const yAxis = sciChartSurface.yAxes.get(index);
xAxis.axisTitleStyle.color = primaryColors[index];
yAxis.axisTitleStyle.color = primaryColors[index];
xAxis.majorTickLineStyle = { color: primaryColors[index] };
yAxis.majorTickLineStyle = { color: primaryColors[index] };
xAxis.labelStyle.color = primaryColors[index];
yAxis.labelStyle.color = primaryColors[index];
xAxis.axisBorder.borderTop = 2;
xAxis.axisBorder.borderBottom = 2;
xAxis.axisBorder.borderRight = 2;
xAxis.axisBorder.borderLeft = 2;
xAxis.axisBorder.color = primaryColors[index];
yAxis.axisBorder.borderTop = 2;
yAxis.axisBorder.borderBottom = 2;
yAxis.axisBorder.borderRight = 2;
yAxis.axisBorder.borderLeft = 2;
yAxis.axisBorder.color = primaryColors[index];
xAxis.labelStyle.alignment = ELabelAlignment.Center;
yAxis.labelStyle.alignment = ELabelAlignment.Center;
xAxis.axisRenderer.keepLabelsWithinAxis = true;
yAxis.axisRenderer.keepLabelsWithinAxis = true;
xAxis.visibleRange = new NumberRange(-10, 110);
yAxis.visibleRange = new NumberRange(-10, 140);
const dataSeries = new XyDataSeries(wasmContext, { containsNaN: false, isSorted: true });
for (let i = 0; i < 100; i++) {
const y = Math.sin(i * 0.1) * i + 50;
dataSeries.append(i, y);
}
const lineSeries = new FastLineRenderableSeries(wasmContext, {
dataSeries,
xAxisId: xAxis.id,
yAxisId: yAxis.id,
strokeThickness: 3,
stroke: primaryColors[index],
});
sciChartSurface.renderableSeries.add(lineSeries);
});
// leave only one border for Inner Axes
xAxis4.axisBorder.borderRight = 0;
xAxis4.axisBorder.borderBottom = 0;
xAxis4.axisBorder.borderLeft = 0;
yAxis4.axisBorder.borderTop = 0;
yAxis4.axisBorder.borderBottom = 0;
yAxis4.axisBorder.borderLeft = 0;
sciChartSurface.chartModifiers.add(
new ZoomPanModifier({
includedXAxisIds: [xAxis1.id, xAxis4.id],
includedYAxisIds: [yAxis1.id, yAxis4.id],
}),
new XAxisDragModifier(),
new YAxisDragModifier()
);
const series4ScaleFactor = 3;
console.log(" xAxis1.visibleRange", xAxis1.visibleRange);
console.log(" yAxis1.visibleRange", yAxis1.visibleRange);
xAxis4.visibleRange = new NumberRange(
(xAxis1.visibleRange.min - verticalAxisPosition) * series4ScaleFactor,
(xAxis1.visibleRange.max - verticalAxisPosition) * series4ScaleFactor
);
yAxis4.visibleRange = new NumberRange(
(horizontalAxisPosition - yAxis1.visibleRange.max) * series4ScaleFactor,
(horizontalAxisPosition - yAxis1.visibleRange.min) * series4ScaleFactor
);
xAxis2.visibleRangeChanged.subscribe((data) => {
xAxis3.visibleRange = data.visibleRange;
});
yAxis2.visibleRangeChanged.subscribe((data) => {
yAxis3.visibleRange = data.visibleRange;
});
xAxis3.visibleRangeChanged.subscribe((data) => {
xAxis2.visibleRange = data.visibleRange;
});
yAxis3.visibleRangeChanged.subscribe((data) => {
yAxis2.visibleRange = data.visibleRange;
});
return { sciChartSurface, wasmContext };
};
This example demonstrates the integration of SciChart.js within a React application using the <SciChartReact/> component. It showcases advanced axis layout options by configuring outer, inner, central, and stacked axes to achieve a highly customizable and dynamic chart.
The chart is initialized by passing an asynchronous function via the initChart prop on the <SciChartReact/> component, which creates and configures the SciChartSurface using JSON-based settings. Multiple axes are instantiated with various configurations such as flipped coordinates, custom axis alignment, stacked axis, inner axis, central axis and dynamic positioning using the Vertically Stacked Axis feature. Event subscriptions like axis.visibleRangeChanged are used to synchronize axis ranges across the chart. For more detailed guidance on initializing SciChart surfaces in React, refer to the Tutorial on Setting Up a Project with scichart-react.
A Key feature is advanced customizations. The example binds unique data series to each axis pair with individually styled properties, and integrates interactive modifiers such as ZoomPanModifier, XAxisDragModifier, and YAxisDragModifier to enhance user interaction. These features guarantee high-performance rendering through WebGL and ensure that extensive diagnostic and performance tuning across axes is possible. Additional insights into performance optimizations can be found in Performance Optimisation of JavaScript Applications & Charts.
This implementation exemplifies robust React integration by leveraging React hooks along with the <SciChartReact/> component, thereby ensuring efficient lifecycle management and update synchronization. Developers are encouraged to explore best practices in React component optimization and state management as demonstrated in React Charts with SciChart.js. Furthermore, the example utilizes advanced custom axis layout techniques as detailed in the SciChart.js Axis Documentation and Advanced Layout Management. It also demonstrates best practices for performance using React hooks such as useMemo and useCallback, as described in Mastering useCallback and useMemo in React: A Deep Dive into Performance Optimization.










