Demonstrates how to use Multi-Line Text for axis labels using SciChart.js, High Performance JavaScript Charts
import {
XyDataSeries,
TextLabelProvider,
NumericAxis,
FastColumnRenderableSeries,
SciChartSurface,
Thickness,
EAutoRange,
ELabelAlignment,
WaveAnimation,
NumberRange,
PaletteFactory,
Point,
GradientParams,
EHorizontalTextPosition,
EVerticalTextPosition,
TextAnnotation,
EHorizontalAnchorPoint,
ECoordinateMode,
} from "scichart";
import { appTheme } from "./appTheme";
export const drawExample = async (rootElement: string | HTMLDivElement) => {
// Dataset = 'percentage market share of phones, 2022'
const dataset = [
{ name: "Apple", percent: 28.41 },
{ name: "Samsung", percent: 28.21 },
{ name: "Xiaomi", percent: 12.73 },
{ name: "Huawei", percent: 5.27 },
{ name: "Oppo", percent: 5.53 },
{ name: "Vivo", percent: 4.31 },
{ name: "Realme", percent: 3.16 },
{ name: "Motorola", percent: 2.33 },
{ name: "Unknown", percent: 2.19 },
{ name: "LG", percent: 0.85 },
{ name: "OnePlus", percent: 1.11 },
{ name: "Tecno", percent: 1.09 },
{ name: "Infinix", percent: 0.96 },
{ name: "Google", percent: 0.77 },
{ name: "Nokia", percent: 0.45 },
];
// Create the SciChartSurface with theme
const { sciChartSurface, wasmContext } = await SciChartSurface.create(rootElement, {
theme: appTheme.SciChartJsTheme,
});
// Create the XAxis labelprovider (maps x-value to axis label)
const labelProvider = new TextLabelProvider({
labels: dataset.map((row) => "Manufacturer " + row.name + " (2022)"),
maxLength: 15,
rotation: 30,
});
// Create an XAxis
const xAxis = new NumericAxis(wasmContext, {
// labelprovider maps Xaxis values (in this case index) to labels (in this case manufacturer name)
labelProvider,
labelStyle: {
alignment: ELabelAlignment.Center,
padding: new Thickness(2, 1, 2, 1),
fontSize: 11,
},
// Ensure there can be 1 label per item in the dataset.
// Also see major/minor delta in the docs
maxAutoTicks: 15,
// add the title
axisTitle: "Mobile phone manufacturer",
growBy: new NumberRange(0.05, 0.05), // add some horizontal padding
});
// additional axis options
//
// Prevent overlapping labels from drawing
xAxis.axisRenderer.hideOverlappingLabels = false;
// Keep first and last labels aligned to their ticks
xAxis.axisRenderer.keepLabelsWithinAxis = false;
sciChartSurface.xAxes.add(xAxis);
// Create a Y-Axis with standard properties
sciChartSurface.yAxes.add(
new NumericAxis(wasmContext, {
autoRange: EAutoRange.Always,
axisTitle: "Market Share (%)",
growBy: new NumberRange(0, 0.1),
labelPostfix: " %",
})
);
// Add a column series.
sciChartSurface.renderableSeries.add(
new FastColumnRenderableSeries(wasmContext, {
// Name index to xvalue for category axis
// Map percentage to yvalue
// store the manufacturer name in the metadata (used to generate colors)
dataSeries: new XyDataSeries(wasmContext, {
xValues: dataset.map((row, index) => index),
yValues: dataset.map((row) => row.percent),
}),
strokeThickness: 1,
// Optional datalabels on series. To enable set a style and position
dataLabels: {
horizontalTextPosition: EHorizontalTextPosition.Center,
verticalTextPosition: EVerticalTextPosition.Above,
style: { fontFamily: "Default", fontSize: 16, padding: new Thickness(0, 0, 5, 0) },
color: appTheme.ForegroundColor,
},
// each column occupies 50% of available space
dataPointWidth: 0.5,
// add a corner radius. Why not!
cornerRadius: 10,
// add a gradient fill in X (why not?)
paletteProvider: PaletteFactory.createGradient(
wasmContext,
new GradientParams(new Point(0, 0), new Point(1, 1), [
{ offset: 0, color: appTheme.VividPink },
{ offset: 0.2, color: appTheme.VividOrange },
{ offset: 0.3, color: appTheme.MutedRed },
{ offset: 0.5, color: appTheme.VividGreen },
{ offset: 0.7, color: appTheme.VividSkyBlue },
{ offset: 0.9, color: appTheme.Indigo },
{ offset: 1, color: appTheme.DarkIndigo },
]),
{ enableFill: true }
),
// Bit more eye candy ;)
animation: new WaveAnimation({ duration: 1000 }),
})
);
// Add title annotation
sciChartSurface.annotations.add(
new TextAnnotation({
text: "Multi-Line and Rotated Axis Labels in SciChart.js",
fontSize: 16,
textColor: appTheme.ForegroundColor,
x1: 0.5,
y1: 0,
opacity: 0.77,
horizontalAnchorPoint: EHorizontalAnchorPoint.Center,
xCoordinateMode: ECoordinateMode.Relative,
yCoordinateMode: ECoordinateMode.Relative,
})
);
return { sciChartSurface, wasmContext, labelProvider };
};
This example demonstrates how to implement multi-line labels and rotated axis labels using SciChart.js with JavaScript. The chart visualizes 2022 market share data for mobile phone manufacturers and uses a custom TextLabelProvider to map data indices to descriptive labels. For more details, refer to the Text and Multi-Line Labels documentation.
The implementation starts by asynchronously creating a SciChartSurface and handling the underlying WebAssembly context as explained in the Creating a new SciChartSurface guide. The X-Axis leverages a TextLabelProvider configured with properties for maximum text length and rotation (e.g., TextLabelProvider.maxLength and TextLabelProvider.rotation properties) to ensure label clarity. This configuration is further elaborated in the Text / String Axis documentation. Additionally, gradient fill customization for the column series is applied using the PaletteFactory Helper Class, and a wave animation effect is integrated via the Animations API.
The example features real-time update capabilities where label properties such as rotation and maximum length can be dynamically adjusted. It employs a high-performance FastColumnRenderableSeries to render the data efficiently, which is critical for handling complex chart visualizations. Performance optimization techniques can be explored further in the Performance Tips & Tricks documentation.
This implementation adheres to best practices for JavaScript integration by directly initializing chart components without reliance on a Builder API. Developers are encouraged to utilize the TextLabelProvider for versatile label formatting and to manage the WASM context effectively to ensure optimal performance. The approach presented here serves as a practical example of enhancing chart readability and visual appeal using advanced SciChart.js features.


