SciChart.js JavaScript 2D Charts API > Builder (JSON Chart Definition) API > Intro to the Builder API
Intro to the Builder API

The Builder API is a new API to SciChart.js v2. In addition to programmatically creating charts with JavaScript or TypeScript code, you can now create charts with a JSON-object API, either with objects in code with discovererable intellisense, or with JSON passed from server to client.

The Builder API is intended to:

  • Provide a more familiar api to javascript developers
  • Provide better discoverability of SciChart features when using typescript
  • Enable charts to be defined using pure data, so that they can be serialized and deserialized

It is not intended to completely replace the existing API. The two can be used in combination, and the original api is more suitable for some tasks, and required for others. Currently it only supports 2D charts.

Discovering the Builder API

To use the SciChart.js Builder API, you will need this import.

Example Title
Copy Code
import { chartBuilder } from "scichart/Builder/chartBuilder";

chartBuilder exposes all the builder methods, which can be used to build parts of, or the entire chart from a JSON definition.

The top level method is buildChart, which takes the id of the target div, and a definition, which can be a JSON string or an object.

Note that all the elements are optional. This lets you define partial definitions that you can reuse and combine.

Worked Examples of the Builder API

We've created some worked examples of the Builder API on the following pages. Also check out our Github and SciChart demo where we have published some examples of the Builder API.

Builder API Documentation Pages

Builder API Examples

 

TypeScript Intellisense

The Builder API is best when used with Typescript, so it can guide you as to what types are available or required.

Intellisense shows which options can be passed to buildChart:

Intellisense will show you the series definition must have a type property which is an ESeriesType. This shows you all the series types that SciChart provides (more than shown in this screenshot).

Once you have selected a series, the properties and types will become specific to that series type:

See Also