Demonstrates different Zoom and Pan Modifiers on a React Chart including Mousewheel, Pinchzoom, Rubber-band zoom.
import { appTheme } from "./appTheme";
import { ExampleDataProvider } from "./ExampleDataProvider";
import {
easing,
EHorizontalAnchorPoint,
EllipsePointMarker,
ENumericFormat,
EVerticalAnchorPoint,
FastLineRenderableSeries,
MouseWheelZoomModifier,
NumberRange,
NumericAxis,
RubberBandXyZoomModifier,
SciChartSurface,
XyDataSeries,
ZoomExtentsModifier,
ZoomPanModifier,
EExecuteOn,
TextAnnotation,
ECoordinateMode,
NativeTextAnnotation,
EWrapTo,
} from "scichart";
export const drawExample = async (rootElement: string | HTMLDivElement) => {
// Create a SciChartSurface with X,Y Axis
const { sciChartSurface, wasmContext } = await SciChartSurface.create(rootElement, {
theme: appTheme.SciChartJsTheme,
});
sciChartSurface.xAxes.add(
new NumericAxis(wasmContext, {
growBy: new NumberRange(0.05, 0.05),
labelFormat: ENumericFormat.Decimal,
labelPrecision: 4,
})
);
sciChartSurface.yAxes.add(
new NumericAxis(wasmContext, {
growBy: new NumberRange(0.1, 0.1),
labelFormat: ENumericFormat.Decimal,
labelPrecision: 4,
})
);
// Add some data
const data1 = ExampleDataProvider.getFourierSeriesZoomed(0.6, 0.13, 5.0, 5.15);
const lineSeries0 = new FastLineRenderableSeries(wasmContext, {
dataSeries: new XyDataSeries(wasmContext, {
xValues: data1.xValues,
yValues: data1.yValues,
dataSeriesName: "First Line Series",
}),
strokeThickness: 3,
stroke: appTheme.VividSkyBlue,
pointMarker: new EllipsePointMarker(wasmContext, {
width: 7,
height: 7,
strokeThickness: 0,
fill: appTheme.VividSkyBlue,
}),
});
sciChartSurface.renderableSeries.add(lineSeries0);
const data2 = ExampleDataProvider.getFourierSeriesZoomed(0.5, 0.12, 5.0, 5.15);
const lineSeries1 = new FastLineRenderableSeries(wasmContext, {
dataSeries: new XyDataSeries(wasmContext, {
xValues: data2.xValues,
yValues: data2.yValues,
dataSeriesName: "Second Line Series",
}),
strokeThickness: 3,
stroke: appTheme.VividOrange,
pointMarker: new EllipsePointMarker(wasmContext, {
width: 7,
height: 7,
strokeThickness: 0,
fill: appTheme.VividOrange,
}),
});
sciChartSurface.renderableSeries.add(lineSeries1);
const data3 = ExampleDataProvider.getFourierSeriesZoomed(0.4, 0.11, 5.0, 5.15);
const lineSeries2 = new FastLineRenderableSeries(wasmContext, {
dataSeries: new XyDataSeries(wasmContext, {
xValues: data3.xValues,
yValues: data3.yValues,
dataSeriesName: "Third Line Series",
}),
strokeThickness: 3,
stroke: appTheme.MutedPink,
pointMarker: new EllipsePointMarker(wasmContext, {
width: 7,
height: 7,
strokeThickness: 0,
fill: appTheme.MutedPink,
}),
});
sciChartSurface.renderableSeries.add(lineSeries2);
// Here is where we add the zoom, pan behaviour
sciChartSurface.chartModifiers.add(
// use RubberBandXyZoomModifier with Right Mouse Button
// use easingFunction to animate zoom
new RubberBandXyZoomModifier({
executeCondition: { button: EExecuteOn.MouseRightButton },
easingFunction: easing.elastic,
}),
// enable pan withZoomPanModifier, and additionally e PinchZoom to allow zooming with pinch gesture on touch devices by setting enableZoom
new ZoomPanModifier({ enableZoom: true }),
new MouseWheelZoomModifier(),
// remark: PinchZoom functionality was included into ZoomPanModifier.
// if having any conflicts, check the value of modifier.enableZoom
// new PinchZoomModifier(),
// Zoom extents on double click
new ZoomExtentsModifier({ easingFunction: easing.elastic })
);
// Add annotations to tell the user what to do
sciChartSurface.annotations.add(
new TextAnnotation({
text: "Zoom Pan Modifiers Demo",
x1: 0.5,
y1: 0.5,
yCoordShift: -50,
xCoordinateMode: ECoordinateMode.Relative,
yCoordinateMode: ECoordinateMode.Relative,
horizontalAnchorPoint: EHorizontalAnchorPoint.Center,
verticalAnchorPoint: EVerticalAnchorPoint.Center,
opacity: 0.33,
fontSize: 48,
fontWeight: "Bold",
})
);
sciChartSurface.annotations.add(
new TextAnnotation({
text: "Multiple zoom, pan behaviours enabled on a single chart",
x1: 0.5,
y1: 0.5,
yCoordShift: 0,
xCoordinateMode: ECoordinateMode.Relative,
yCoordinateMode: ECoordinateMode.Relative,
horizontalAnchorPoint: EHorizontalAnchorPoint.Center,
verticalAnchorPoint: EVerticalAnchorPoint.Center,
opacity: 0.38,
fontSize: 20,
})
);
sciChartSurface.annotations.add(
new NativeTextAnnotation({
text: "Try mouse-wheel, left/right mouse drag, mousewheel on axis, pinch zoom, double-click to zoom to fit etc...",
x1: 0.5,
y1: 0.6,
xCoordinateMode: ECoordinateMode.Relative,
yCoordinateMode: ECoordinateMode.Relative,
horizontalAnchorPoint: EHorizontalAnchorPoint.Center,
verticalAnchorPoint: EVerticalAnchorPoint.Center,
opacity: 0.45,
fontSize: 17,
wrapTo: EWrapTo.ViewRect,
})
);
return { wasmContext, sciChartSurface };
};
This example demonstrates how to create a high-performance, interactive chart in a React environment using SciChart.js. The chart showcases multiple zoom and pan behaviors including rubber-band zoom, pinch zoom, mouse-wheel zoom, and double-click zoom-to-fit. Data is dynamically generated via Fourier series, and the visual display is enriched with annotations to guide user interactions.
The implementation leverages the <SciChartReact/> component which integrates SciChart.js into React applications. The core of the example is defined in the drawExample function where a SciChartSurface is instantiated with configurable numeric axes and real-time series data. Multiple chart modifiers are added: the RubberBandXyZoomModifier (triggered on the right mouse button) applies an elastic easing function for smooth zoom animations, while the ZoomPanModifier (with pinch zoom enabled), MouseWheelZoomModifier, and ZoomExtentsModifier further enhance user interactivity. Developers can find more details on this approach in the React Charts with SciChart.js guide and explore zoom and pan specifics via the SciChart.js Zooming and Panning documentation.
The chart features advanced zooming and panning capabilities that include rubber-band and pinch zoom along with mouse-wheel interactions and double-click zoom extents. It also incorporates animated transitions using an elastic easing function for a seamless user experience. Annotations, both text and native, are implemented to provide contextual instructions and enhance the user interface. Learn more about these advanced features on the SciChart.js Demo for Multiple Modifiers.
The example is implemented as a React component, using the <SciChartReact/> wrapper to initialize and render the chart. This encapsulates the chart creation process and allows for efficient resource management. Developers are encouraged to follow best practices for memory management by properly disposing of the SciChartSurface when unmounting components. For additional guidance on building robust React components with SciChart.js, see the How to Make Charts in React from Scratch? - SciChart article and related resource management tips.








