DXCharts Lite - one of the most powerful financial charting tools
DXcharts Lite is a modern solution made for visualization financial data with full variety of charts.
It's been created and tempered as a part of big tradings apps with millions of users.
Now it's grown enough to be recognized as independent product capable to support any from your needs
as a simple widget for blog and as a part of big enterprise solution for trading.
Overview
Get started with DXCharts Lite, install the library and configure it as you want.
Quick-start
Installation
Install library to your project:
npm install @devexperts/dxcharts-lite
Your package.json
after installation:
"dependencies": {
"@devexperts/dxcharts-lite": "1.0.0",
...
}
Create chart
If you use webpack or any other bundler - import createChart
method and pass element where the chart will be rendered as a first argument.
export const createChartInstance = () => {
const container = document.getElementById('chart_container');
const chartInstance = DXChart.createChart(container);
return chartInstance;
};
createChart
- method, that creates a new chart instance using ChartBootstrap class and returns it.
Method accepts 2 parameters:
element
- The HTML element where the chart will be renderedconfig
(optional) - instance of ChartConfig
Also, please, set width: 100%
and height: 100%
for parent container
by default chart is auto-resizing to parent
you can change it by setting fixedSize
in config
Now you should have empty chart on screen.
Set data
Let's pass in some data i.e. Candles
. You can use bundled function to generate some mock data.
Import generateCandlesData
and call it to generate candles.
Also, you would need Instrument
object - it is required to show instrument description on chart and show correct price precisions on Y axis.
export const generateMockData = () => {
const mockCandles = generateCandlesData();
const mockInstrument = {
symbol: 'AAPL',
priceIncrements: [0.01],
};
chartInstance.chartComponent.setMainSeries({ candles: mockCandles, instrument: mockInstrument });
};
Now you should see chart just like image below:
HTML-markup
Here is full quick-start code example:
<html>
<head>
<script src="https://webdev.prosp.devexperts.com:8095/dxcharts-lite-cdn/dxchart.min.js"></script>
</head>
<body>
<div id="chart_container"></div>
</body>
<script type="module">
import generateCandlesData from 'https://webdev.prosp.devexperts.com:8095/dxcharts-lite-cdn/chart/utils/candles-generator.utils.js';
// create chart instance, pass parent container as 1st argument
const container = document.getElementById("chart_container");
const chartInstance = DXChart.createChart(container);
// create and set candles data
const mockCandles = generateCandlesData();
const mockInstrument = {
symbol: 'AAPL',
priceIncrements: [0.01],
};
chartInstance.chartComponent.setMainSeries({ candles: mockCandles, instrument: mockInstrument });
</script>
Configuration
You can configure chart with ChartConfig
object. It is optional.
ChartConfig
is used to set initial properties for chart instance.
Below you can see full table of it, and other options, that ChartConfig
consists of.
API
Every chart component has an API allowing change a lot of params on the fly.
Change appearance at runtime.
Subscribe on different events in chart (like HOVER on candle)
Here are the links of the main components:
Examples
We have created a lot of examples with different chart configuration.
You can find them here.
Demo
To show you how it's beautiful, we have created Demo version, based on DXCharts Lite. Feel all power of our library!