ToastUI Chart

Beautiful chart for data visualization.

Charting
nhn/tui.chartui.toast.com/tui-chart/tui-chart

README

Toast UI Chart


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

GitHub release npm GitHub license PRs welcome code with hearth by NHN Cloud lerna

📦 Packages


The functionality of TOAST UI Chart is available when using the Plain JavaScript, React, Vue Component.

- toast-ui.chart - Plain JavaScript component implemented by NHN Cloud.
- toast-ui.vue-chart -Vue wrapper component implemented by NHN Cloud.
- toast-ui.react-chart -React wrapper component implemented by NHN Cloud.

📙 Documents


- Getting Started
- Tutorials
  - English
  - 한국어
- APIs
- v4.0 Migration Guide
  - English
  - 한국어

😍 Why TOAST UI Chart?


Simple, Easy to Use, And It's Beautiful!


TOAST UI Chart makes your data pop and presents it in a manner that is easy to understand. Furthermore, it provides a wide range of theme options for customizing the charts to be suitable for all of your services. Chart components like the title, axes, legends, tooltips, plots, series, and more can be customized through the options.

image

Variety of powerful features!


Responsive


Add different options and animations according to the charts' sizes by using the responsive option.

responsive

Zoomable


Make the data presented in the Line, Area, and Treemap Charts zoomable with the zoomable option.

zoomable

Live Update


View and manage new data as they are added realtime with the addData API and the options.series.shift option.

AreaLineHeatmap
|---------
![area](https://user-images.githubusercontent.com/35371660/102159207-6ee6d380-3ec6-11eb-8ca8-07c82095556f.gif)![live![heatmap](https://user-images.githubusercontent.com/35371660/102159193-68f0f280-3ec6-11eb-9b1f-4fa14c97c879.gif)

LineAreaColumnColumnLine
|---------
![lineArea](https://user-images.githubusercontent.com/35371660/102160638-2aa90280-3ec9-11eb-98ae-5113cd3f75eb.gif)![column](https://user-images.githubusercontent.com/35371660/102159210-70b09700-3ec6-11eb-9f78-9d9790cd0357.gif)![columnline](https://user-images.githubusercontent.com/35371660/102159292-976ecd80-3ec6-11eb-84b9-4e487e411245.gif)

Synchronize Tooltip


Use and synchronize the tooltip features at the moment the cursor hovers over the chart with the showTooltip API and the on custom event.

synctooltip

🎨 Features


Charts


The TOAST UI Chart provides many types of charts to visualize the various forms of data.

[Area](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-area.md)[Line](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-line.md)[Bar](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-bar.md)[Column](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-column.md)
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[Bullet](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-bullet.md)[BoxPlot](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-boxplot.md)[Treemap](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-treemap.md)[Heatmap](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-heatmap.md)
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[Scatter](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-scatter.md)[Bubble](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-bubble.md)[Radar](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-radar.md)[Pie](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-pie.md)
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[LineArea](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-lineArea.md)[LineScatter](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-lineScatter.md)[ColumnLine](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-columnLine.md)[NestedPie](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-nestedPie.md)
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[RadialBar](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-radialBar.md)[Gauge](https://github.com/nhn/tui.chart/blob/main/docs/en/chart-gauge.md)|
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

- Stack Options(Explained in each chart guide)
- Diverging Options(Explained in each chart guide)
- Change Event Detect Type(Explained in each chart guide)
- Custom Theme
- Custom Tooltip
- [Export xls, csv, png, jpeg file](https://github.com/nhn/tui.chart/blob/main/docs/en/common-exportMenu.md)
- Live Update
- Responsive Layout

In addition, a variety of powerful features can be found on the demo page below. 👇👇👇

🐾 Examples


- Line Chart
- Area Chart
- LineArea Chart
- Bar Chart
- Column Chart
- ColumnLine Chart
- Bullet Chart
- BoxPlot Chart
- Treemap Chart
- Heatmap Chart
- Scatter Chart
- LineScatter Chart
- Bubble Chart
- Pie Chart
- NestedPie Chart
- Radar Chart
- RadialBar Chart
- Gauge Chart

Here are more examples and play with TOAST UI Chart!

🔧 Pull Request Steps


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 main branch into your personal repository.
Clone it to local computer. Install node modules.
Before starting development, you should check to have any errors.

  1. ```sh
  2. $ git clone https://github.com/{your-personal-repo}/tui.chart.git
  3. $ npm install
  4. $ cd apps/chart
  5. $ npm install
  6. $ npm run test
  7. ```

Develop


Let's start development!
You can develop UI through webpack-dev-server or storybook, and you can write tests through Jest.
Don't miss adding test cases and then make green rights.

Run webpack-dev-server


  1. ```sh
  2. $ npm run serve
  3. ```

Run storybook


  1. ```sh
  2. $ npm run storybook
  3. ```

Run test


  1. ```sh
  2. $ npm run test
  3. ```

Pull Request


Before uploading your PR, run test one last time to check if there are any errors.
If it has no errors, commit and then push it!

For more information on PR's steps, please see links in the Contributing section.

💬 Contributing


- Code of Conduct
- Contributing guideline
- Issue guideline
- Commit convention

🌏 Browser Support


| Chrome Chrome | IE Internet Explorer | Edge Edge | Safari Safari | Firefox Firefox |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|                                                                               Yes                                                                                |                                                                                   10+                                                                                   |                                                                             Yes                                                                              |                                                                               Yes                                                                                |                                                                                Yes                                                                                 |

🍞 TOAST UI Family


- TOAST UI Editor
- TOAST UI Grid
- TOAST UI Calendar
- TOAST UI Image-Editor
- TOAST UI Components

🚀 Used By


- NHN Cloud - Total Cloud Service
- NHN - ToastCam
- NHN Dooray! - Collaboration Service (Project, Messenger, Mail, Calendar, Drive, Wiki, Contacts)
- NHN - Smart Downloader
- NHN - Gamebase
- NHN Edu - iamTeacher
- HANGAME
- Payco

📜 License


This software is licensed under the MIT © NHN Cloud.