Bubble Chart in EJ2 TypeScript control

13 Dec 202424 minutes to read

Bubble

To render a bubble series in your chart, you need to follow a few steps to configure it correctly. Here’s a concise guide on how to do this:

Set the series type: Define the series type as Bubble in your chart configuration. This indicates that the data should be displayed as a bubble series in the chart.
Inject the BubbleSeries module: Use the Chart.Inject(BubbleSeries) method to inject the BubbleSeries module into your chart. This step is essential, as it ensures that the necessary functionalities for rendering the bubble series are available in your chart.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size'
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: 6.0,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: 0.2,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Binding data with series

You can bind data to the chart using the dataSource property within the series configuration. This allows you to connect a JSON dataset or remote data to your chart. To display the data correctly, map the fields from the data to the chart series xName and yName properties.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);
let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size'
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: 6.0,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: 0.2,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Series customization

The following properties can be used to customize the bubble series.

Fill

The fill property determines the color applied to the series.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size', fill: 'blue'
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: 6.0,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: 0.2,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Opacity

The opacity property specifies the transparency level of the fill. Adjusting this property allows you to control how opaque or transparent the fill color of the series appears.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size', fill: 'blue',
            opacity: 0.5
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: 6.0,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: 0.2,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Bubble size mapping

Use the size property to map the size of each bubble to the value specified in the data source.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size'
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: 6.0,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: 0.2,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Empty points

Data points with null or undefined values are considered empty. Empty data points are ignored and not plotted on the chart.

Mode

Use the mode property to define how empty or missing data points are handled in the series. The default mode for empty points is Gap.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size', 
            emptyPointSettings: {
                mode: 'Zero'
            }
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: null,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: undefined,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Fill

Use the fill property to customize the fill color of empty points in the series.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size', 
            emptyPointSettings: {
                mode: 'Zero',
                fill: 'red'
            }
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: null,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: undefined,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Border

Use the border property to customize the width and color of the border for empty points.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size', 
            emptyPointSettings: {
                mode: 'Zero',
                fill: 'red',
                border: { width: 2, color: 'green' }
            }
        }
    ],
    title: 'GDP vs Literacy Rate'
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: null,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: undefined,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Events

Series render

The seriesRender event allows you to customize series properties, such as data, fill, and name, before they are rendered on the chart.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries, ISeriesRenderEventArgs } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y', 
            size: 'size'
        }
    ],
    title: 'GDP vs Literacy Rate',
    seriesRender: (args: ISeriesRenderEventArgs) => {
        args.fill = '#ff6347';
    }
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: 6.0,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: 0.2,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];

Point render

The pointRender event allows you to customize each data point before it is rendered on the chart.

index.ts
index.html
datasource.ts
import { Chart, BubbleSeries, IPointRenderEventArgs } from '@syncfusion/ej2-charts';
import { bubbleData } from './datasource.ts';
Chart.Inject(BubbleSeries);

let chart: Chart = new Chart({
    primaryXAxis: {
        title: 'Literacy Rate',
        minimum: 60,
        maximum: 100,
        interval: 5
    },
    primaryYAxis: {
        title: 'GDP growth rate',
        minimum: -2,
        maximum: 16,
        interval: 2
    },
    series: [
        {
            type: 'Bubble',
            dataSource: bubbleData,
            xName: 'x', yName: 'y',
            size: 'size'
        }
    ],
    title: 'GDP vs Literacy Rate',
    pointRender: (args: IPointRenderEventArgs) => {
        if (args.point.y < 4) {
            args.fill = '#ff6347';
        }
        else {
            args.fill = '#009cb8';
        }
    }
}, '#element');
<!DOCTYPE html>
<html lang="en">

<head>
    <title>EJ2 Animation</title>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="description" content="Typescript UI Controls" />
    <meta name="author" content="Syncfusion" />
    <link href="index.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/systemjs/0.19.38/system.js"></script>
    <script src="systemjs.config.js"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>

<body>
    <div id='loader'>Loading....</div>
    <div id='container'>
        <div id='element'></div>
    </div>
</body>

</html>
export let bubbleData: Object[] = [
    { x: 92.2, y: 7.8,  size: 1.347 },
    { x: 74,   y: 6.5,  size: 1.241 },
    { x: 90.4, y: 6.0,  size: 0.238 },
    { x: 99.4, y: 2.2,  size: 0.312 },
    { x: 88.6, y: 1.3,  size: 0.197 },
    { x: 99,   y: 0.7,  size: 0.0818 },
    { x: 72,   y: 2.0,  size: 0.0826 },
    { x: 99.6, y: 3.4,  size: 0.143 },
    { x: 99,   y: 0.2,  size: 0.128 },
    { x: 86.1, y: 4.0,  size: 0.115 },
    { x: 92.6, y: 6.6,  size: 0.096 },
    { x: 61.3, y: 14.5, size: 0.162 }
];