React Chart with Secondary Y Axes

Demonstrates how to create a React Chart with Secondary Y axis using SciChart.js, High Performance JavaScript Charts

src/drawExample.ts
import {
    EAxisAlignment,
    ECoordinateMode,
    EHorizontalAnchorPoint,
    ELabelAlignment,
    EllipsePointMarker,
    EMultiLineAlignment,
    ENumericFormat,
    EVerticalAnchorPoint,
    EWrapTo,
    FastLineRenderableSeries,
    MouseWheelZoomModifier,
    NativeTextAnnotation,
    NumberRange,
    NumericAxis,
    SciChartSurface,
    TextAnnotation,
    XAxisDragModifier,
    XyDataSeries,
    YAxisDragModifier,
    ZoomExtentsModifier,
    ZoomPanModifier,
} from "scichart";
import { RandomWalkGenerator } from "./RandomWalkGenerator";
import { appTheme } from "./appTheme";

const ID_Y_AXIS_2 = "yAxis2";

export const drawExample = async (rootElement: string | HTMLDivElement) => {
    // Create the SciChartSurface with theme
    const { sciChartSurface, wasmContext } = await SciChartSurface.create(rootElement, {
        theme: appTheme.SciChartJsTheme,
    });

    // Add a primary X,Y Axis pair
    sciChartSurface.xAxes.add(
        new NumericAxis(wasmContext, {
            axisAlignment: EAxisAlignment.Bottom,
            axisTitle: "Shared X Axis",
            axisTitleStyle: {
                color: appTheme.VividGreen,
                fontSize: 30,
            },
            labelStyle: {
                color: appTheme.VividGreen,
            },
            backgroundColor: appTheme.VividGreen + "22",
            axisBorder: {
                borderTop: 1,
                color: appTheme.VividGreen,
            },
        })
    );

    sciChartSurface.yAxes.add(
        new NumericAxis(wasmContext, {
            axisAlignment: EAxisAlignment.Left,
            axisTitle: "Y Axis Left",
            axisTitleStyle: {
                color: appTheme.VividSkyBlue,
                fontSize: 30,
            },
            labelStyle: {
                color: appTheme.VividSkyBlue,
            },
            growBy: new NumberRange(0.1, 0.2),
            backgroundColor: appTheme.VividSkyBlue + "22",
            axisBorder: {
                borderRight: 1,
                color: appTheme.VividSkyBlue,
            },
        })
    );

    // generate some data
    let data = new RandomWalkGenerator().Seed(7331).getRandomWalkSeries(100);

    // Add the first line series on the primary X,Y axis
    // This occurs be default as FastLineRenderableSeries XAxisId and YAxisId are set to a default value
    sciChartSurface.renderableSeries.add(
        new FastLineRenderableSeries(wasmContext, {
            stroke: appTheme.VividSkyBlue,
            strokeThickness: 3,
            dataSeries: new XyDataSeries(wasmContext, { xValues: data.xValues, yValues: data.yValues }),
            pointMarker: new EllipsePointMarker(wasmContext, {
                width: 5,
                height: 5,
                fill: appTheme.VividGreen,
                stroke: appTheme.VividGreen,
            }),
        })
    );

    // Add a secondary Y Axis
    sciChartSurface.yAxes.add(
        new NumericAxis(wasmContext, {
            id: ID_Y_AXIS_2,
            axisTitleStyle: {
                color: appTheme.VividOrange,
                fontSize: 30,
            },
            labelStyle: {
                color: appTheme.VividOrange,
                alignment: ELabelAlignment.Right,
            },
            axisAlignment: EAxisAlignment.Right,
            axisTitle: "Y Axis Right",
            labelFormat: ENumericFormat.Decimal,
            labelPrecision: 2,
            growBy: new NumberRange(0.1, 0.2),
            backgroundColor: appTheme.VividOrange + "22",
            axisBorder: {
                borderLeft: 1,
                color: appTheme.VividOrange,
            },
        })
    );

    // Create some data & series for that axis
    data = new RandomWalkGenerator().Seed(1209).getRandomWalkSeries(100);

    // The second line series we specify X/Y axis ids to bind this to the correct axis
    sciChartSurface.renderableSeries.add(
        new FastLineRenderableSeries(wasmContext, {
            stroke: appTheme.VividOrange,
            strokeThickness: 3,
            dataSeries: new XyDataSeries(wasmContext, { xValues: data.xValues, yValues: data.yValues }),
            yAxisId: ID_Y_AXIS_2,
            pointMarker: new EllipsePointMarker(wasmContext, {
                width: 5,
                height: 5,
                fill: appTheme.VividOrange,
                stroke: appTheme.VividOrange,
            }),
        })
    );

    // Optional: Add some interactivity modifiers to enable zooming and panning
    sciChartSurface.chartModifiers.add(
        new YAxisDragModifier(),
        new XAxisDragModifier(),
        new ZoomPanModifier({ enableZoom: true }),
        new MouseWheelZoomModifier(),
        new ZoomExtentsModifier()
    );

    // Add a title over the chart with information
    sciChartSurface.annotations.add(
        new NativeTextAnnotation({
            x1: 0.01,
            y1: 0.01,
            xCoordinateMode: ECoordinateMode.Relative,
            yCoordinateMode: ECoordinateMode.Relative,
            horizontalAnchorPoint: EHorizontalAnchorPoint.Left,
            verticalAnchorPoint: EVerticalAnchorPoint.Top,
            fontSize: 18,
            opacity: 0.55,
            textColor: appTheme.ForegroundColor,
            text: "SciChart.js supports unlimited X,Y axis. Drag an axis to see the series scale",
            wrapTo: EWrapTo.ViewRect,
            multiLineAlignment: EMultiLineAlignment.Left,
        })
    );

    sciChartSurface.annotations.add(
        new TextAnnotation({
            x1: 10,
            y1: 1.1,
            fontSize: 18,
            textColor: appTheme.VividSkyBlue,
            horizontalAnchorPoint: EHorizontalAnchorPoint.Left,
            verticalAnchorPoint: EVerticalAnchorPoint.Bottom,
            text: "Blue series is bound to the Shared X-Axis, and Left Y-Axis",
        })
    );

    // Note annotations need X,Y Axis ID as well in multi-axis scenarios
    sciChartSurface.annotations.add(
        new TextAnnotation({
            x1: 5,
            y1: -1.2,
            fontSize: 18,
            textColor: appTheme.VividOrange,
            yAxisId: ID_Y_AXIS_2,
            text: "Orange series is bound to the Shared X-Axis, and Right Y-Axis",
        })
    );

    return { sciChartSurface, wasmContext };
};

React Chart with Secondary Y Axes

Overview

This example demonstrates how to create a high-performance SciChart.js chart with secondary Y axes using <SciChartReact/>. The chart features two separate Y axes—one on the left and one on the right—with distinct styling and data series bindings. Interactive modifiers enable users to zoom, pan, and drag axes for dynamic chart updates.

Technical Implementation

The implementation leverages the SciChart.js library in a React environment by utilizing the SciChart React component. The chart is created by calling the SciChartSurface.create() method with a theme, after which primary and secondary NumericAxis instances are configured with individual styles and titles. Two FastLineRenderableSeries are added; one is bound to the primary left Y axis by matching axis.id and series.yAxisId and the other to a secondary right Y axis also via its axis.id. Custom point markers are rendered with EllipsePointMarker. For comprehensive guidance on configuring multiple axes, please refer to Tutorial 08 - Adding Multiple Axis.

Features and Capabilities

This example highlights real-time data visualization capabilities and advanced customization. It demonstrates the binding of data series to specific axes, custom styling of axes and series, and the use of interactive modifiers such as YAxisDragModifier, XAxisDragModifier, ZoomPanModifier, MouseWheelZoomModifier, and ZoomExtentsModifier, which collectively provide a fluid and responsive charting experience. Custom annotations further enhance the chart by offering contextual information.

Integration and Best Practices

The React integration is achieved via the <SciChartReact/> component, which simplifies incorporating SciChart.js into React applications. This approach adheres to modern React practices by managing the chart lifecycle within a functional component. Developers should apply best practices such as properly disposing of chart resources on component unmount. Detailed guidance for managing these aspects is provided in the Creating a SciChart React Component from the Ground Up documentation. By combining structured configuration with interactive capabilities, the example serves as a robust reference for building advanced charting solutions in React.