@barchart/chart-lib
v2.277.4
Published
Barchart HTML5 Streaming Chart
Downloads
1,245
Maintainers
Keywords
Readme
Barchart HTML5 chart SDK
The contents of the package
The archive contains the following files:
barchart.chart.js
- the chart component you're integrating into your product(s)barchart.chart.d.ts
- TypeScript declaration file for the library; please note that this is useful for both TypeScript and JavaScript projectsindex.html
- a web page hosting a single chart; please note that you may host many charts inside a single page, we've tested dozens of charts shown simultaneouslyindex.js
- the script needed to add a chart to the page using a custom data feed (complete implementation is provided) for demonstration purposes; in practice, the feed is provided by Barchart and using the chart requires only a few lines of codestyle.css
- a simple CSS for styling some elements of the UI using a dark themechart.def.json
- a default chart definition (its state) with one symbol plot and the volume study using a dark themeAMZN_Daily.json
- a snapshot of Amazon's daily data for demonstration purposesAMZN_Events.json
- a snapshot of Amazon's events data for demonstration purposespackage.json
- an npm package definition
How to run the example
Please note that because the timeseries data is loaded using JavaScript fetch
functionality, the web page must be served using a web server (in other words, you can't just open index.html
from the local filesystem). You could use a very mature and popular one that we like on NPM. Assuming you've decompressed the SDK into the chart-lib
folder, simply go into the chart-lib
folder and run serve .
. By default, the server will serve the index.html
on a port 5000. In order to keep the example running, please contact Barchart and obtain an API key, which should replace the <YOUR_API_KEY>
in the index.js
.
Browser support
In order to keep the chart component's size reasonably small, we have built the component for the last EcmaScript (JavaScript) standard. The last 2 versions of all major browsers support this standard, so you will need a modern browser to use the component.
Please note that the component can be made to support older browsers (for example IE 11, we have not tested older versions) at the expense of its size which typically grows significantly for very old browsers.
Using the library with npm
While the example code (index.html
and related files) is complete and works, it does not show a modern JavaScript development scenario - it's more akin to a traditional approach where you'd reference the library in your HTML, then use the resources from the Barchart "namespace" in your scripts.
However, this is just one and definitely not the only way of using the library. If you would like to reference and build the library with your code and you are using npm - which practically all modern approaches do - and any of the modern bundlers (Webpack, Rollup, Parcel or Vite) and transpilers like Babel, then please do one of the two:
- If you have network access, install our library from npm as usual, that is to say
npm i @barchart/chart-lib
oryarn add @barchart/chart-lib
- If you don't have network access, you may install the package directly from this very archive (no need to decompress) by running
npm i /path/to/chart-lib.tgz
oryarn add file:/path/to/chart-lib.tgz
You are now able to import
any of the functions/classes/constants the chart library exports; these are all documented in the above mentioned TypeScript declaration file. Our module name is @barchart/chart-lib
.
The chart component is framework-agnostic and works equally well with any modern JS framework as well as with no framework at all.
Where to find more information
The chart component/SDK does not ship with any form of UI. The API the chart responds to is documented here. We're busy at work making the docs clearer and easier to use, please check back often.
We do have a product - called widget - which includes the UI. A UI builder producing the small snippet of the HTML needed to get the widget on your page can be seen at the widget site. The very same widget powers our demo site. The widget is written using Barchart's cutting edge (proprietary) library which produces Web Components, helping keep the package size small and efficient.
Please note that we're using the component as-is in many of Barchart's products. The component is in production since 2016 and is battle tested across several different scenarios - both page based and SPA based. We're happy to help you integrate the component into your product(s).