tui.chart: A JavaScript repository from sonphnt

🍞📈 Spread your data on TOAST UI Chart. TOAST UI Chart is Beautiful Statistical Data Visualization library

🚩 Table of Contents

Browser Support
True Cross Browser Charts
Features
Install
- Via Package Manager
- Download Source Files
Load
- namespace
- modules
Usage
- HTML
- JavaScript
Development
- Setup
- Develop
Documents
Contributing
TOAST UI Family
License

🌏 Browser Support

Chrome	Firefox	Safari	Edge	Internet Explorer
Yes	Yes	Yes	Yes	8+

🌈 True Cross Browser Charts And It's Beautiful!

IE8	CHROME

No one like the legacy. But sometimes it matters. That is why we started this project. As we couldn't find a project which supporting legacy browsers, maintained reliably, and free for commercial use.

You can see the charts in IE8 exactly as it looks in Chrome. Of course, there are other projects that support the legacy browser. However, They may function limited, look different or require polyfill that affects performance badly. The TOAST UI Chart guarantees identical look on all browsers. And it draws using what browsers have natively(SVG + RVML). So, It requires no polyfill and draws faster.

The TOAST UI Chart will continue to support legacy browsers as MIT license No wonder the other open source charts stop supporting legacy browsers. It's hard to find open-source charts which reliably maintained. And some of the decent charts ask commercial licenses. The TOAST UI Chart has over 50 releases since Jun. 2015 under MIT License. The TOAST UI Chart is the answer if you have same requirements as us.

🎨 Features

The TOAST UI Chart is an open source JavaScript library that can be used in legacy browsers including IE8. It is intuitive and easy to apply without any other learning. If you like, you can change the chart in detail using many options and custom themes.

Single Charts

The TOAST UI Chart provides many kinds of charts to visualize the various form of data.

Bar Column	Line Area Radial	Bubble Scatter	Pie(General) Pie(Donut)

Heatmap Treemap	Map	Boxplot	Bullet

Combo Charts

The TOAST UI Chart covers even more complex data visualization.

Column-Line	Pie-Donut	Line-Area	Line-Scatter

Customize

Sometimes you may want more options to cover how to visualize data. Then try to customize the detail of the charts. You can change almost everything you see.

Various expressions	Custom theme	Stack option	Diverging option	Group tooltip

And More From Examples

Check out Example and wiki to discover more.

💾 Install

The TOAST UI products can be used by using the package manager or downloading the source directly. However, we highly recommend using the package manager.

Via Package Manager

The TOAST UI products are registered in two package managers, npm and bower. You can conveniently install it using the commands provided by each package manager. When using npm, be sure to use it in the environment Node.js is installed.

npm

$ npm install --save tui-chart # Latest version
$ npm install --save tui-chart@<version> # Specific version

bower

$ bower install tui-chart # Latest version
$ bower install tui-chart#<tag> # Specific version

Download Source Files

🔨 Usage

HTML

Add the container element where TOAST UI Chart will be created.

<div id="chart"></div>

JavaScript

Load

The TOAST UI Chart can be used by creating an instance with the constructor function. To get the constructor function, you should import the module using one of the following three ways depending on your environment.

var chart = tui.chart; /* namespace */

var chart = require('tui-chart'); /* CommonJS in Node.js */

import {chart} from 'tui-chart'; /* ES6 in Node.js */

Factory function needs three paramters: container, data, options

Container: Wrapper HTMLElements that will contain charts as a child
data: numeric data need to make charts
options: functional options like legend aligment or tooltip visiblities

var container = document.getElementById('chart-area');
var data = {
    category: [...], series: [...]
};
var options = {
    chart: {width: 700, height: 400}
};

chart.barChart(container, data, options);

See details for additional informations.

🔧 Development

The TOAST UI products are open source, so you can create a pull request(PR) after you fix issues. Run npm scripts and develop yourself with the following process.

Setup

Fork develop branch into your personal repository. Clone it to local computer. Install node modules. Before starting development, you should check to haveany errors.

$ git clone https://github.com/{username}/tui.chart.git
$ cd tui.chart
$ npm install
$ npm run test

Develop

Let's start development! You can see your code is reflected as soon as you saving the codes by running a server. Don't miss adding test cases and then make green rights.

Run webpack-dev-server

$ npm run serve
$ npm run serve:ie8 # Run on Internet Explorer 8

Run karma test

$ npm run test

Pull Request

Before PR, check to test lastly and then check any errors. If it has no error, commit and then push it!

For more information on PR's step, please see links of Contributing section.

Pull requests

Before PR, check build lastly and then check any errors. If it has no error, commit and then push it!

$ npm run deploy
$ npm run test

sonphnt/tui.chart