API Reference

Sparkline

Packages@univerjs-pro/sheets-sparkline

The facade class for the sparkline.

This class should not be instantiated directly. Use factory methods on univerAPI instead.

Overview

@univerjs-pro/sheets-sparkline

APIs

Setters & Modifiers

changeDataSource

Signature

TypeScript
changeDataSource(sourceRange: IRange, targetRange: IRange): FSparkline | undefined

Parameters

  • sourceRange IRangeNo description
  • targetRange IRangeNo description

Returns

  • FSparkline — Return this, for chaining

Examples

TypeScript
const fWorkbook = univerAPI.getActiveWorkbook();const fWorksheet = fWorkbook.getActiveSheet();// Create a sparkline in the range A10, with the data source in the range A1:A7.const sparkline = fWorksheet.addSparkline(  [fWorksheet.getRange('A1:A7').getRange()],  [fWorksheet.getRange('A10').getRange()]);// Modify the data source of the sparkline to the range B1:B7, and move it to the range B10 after 3 seconds.setTimeout(() => {  sparkline.changeDataSource(    fWorksheet.getRange('B1:B7').getRange(),    fWorksheet.getRange('B10').getRange()  );}, 3000);
Source: @univerjs-pro/sheets-sparkline

setConfig

Signature

TypeScript
setConfig(config: ISparklineGroupConfig): FSparklineGroup

Parameters

  • config ISparklineGroupConfigNo description

Returns

  • FSparklineGroup — Return this instance, for chaining

Examples

TypeScript
const fWorkbook = univerAPI.getActiveWorkbook();const fWorksheet = fWorkbook.getActiveSheet();// Create a sparkline in the range A10, with the data source in the range A1:A7.const sparkline = fWorksheet.addSparkline(  [fWorksheet.getRange('A1:A7').getRange()],  [fWorksheet.getRange('A10').getRange()]);// Get sparkline group by cell A10const sparklineGroup = fWorksheet.getSparklineGroupByCell(9, 0);// Set sparkline type to bar chart after 3 secondssetTimeout(() => {  sparklineGroup.setConfig({    type: univerAPI.Enum.SparklineTypeEnum.BAR_CHART  });}, 3000);
Source: @univerjs-pro/sheets-sparkline

Actions & Operations

removeSparkline

Signature

TypeScript
removeSparkline(): void

Examples

TypeScript
const fWorkbook = univerAPI.getActiveWorkbook();const fWorksheet = fWorkbook.getActiveSheet();// Create a sparkline in the range A10, with the data source in the range A1:A7.const sparkline = fWorksheet.addSparkline(  [fWorksheet.getRange('A1:A7').getRange()],  [fWorksheet.getRange('A10').getRange()]);// Remove the sparkline after 3 seconds.setTimeout(() => {  sparkline.removeSparkline();}, 3000);
Source: @univerjs-pro/sheets-sparkline

removeSparklineGroup

Signature

TypeScript
removeSparklineGroup(): void

Examples

TypeScript
const fWorkbook = univerAPI.getActiveWorkbook();const fWorksheet = fWorkbook.getActiveSheet();// Create a sparkline in the range A10, with the data source in the range A1:A7.const sparkline = fWorksheet.addSparkline(  [fWorksheet.getRange('A1:A7').getRange()],  [fWorksheet.getRange('A10').getRange()]);// Get sparkline group by cell A10const sparklineGroup = fWorksheet.getSparklineGroupByCell(9, 0);setTimeout(() => {  // Remove sparkline group after 3 seconds.  sparklineGroup.removeSparklineGroup();}, 3000);
Source: @univerjs-pro/sheets-sparkline

How is this guide?

© 2026 DreamNum Co., Ltd.