Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

charts-rs

> 编程语言
Open source

A charts library for rust

316 stars0 likes0 views
WebsiteGitHub

About

A charts library for rust

charts-rs

中文

charts-rs is a charting library for rust. It's simple and fast.

[![Crates.io][crates-badge]][crates-url] [![Apache licensed][apache-badge]][apache-url] [crates-badge]: https://img.shields.io/crates/v/charts-rs.svg [crates-url]: https://crates.io/crates/charts-rs [apache-badge]: https://img.shields.io/badge/license-apache2-blue.svg [apache-url]: https://github.com/vicanso/charts-rs/blob/main/LICENSE

Overview

charts-rs provides a straightforward approach to generating charts with support for multiple output formats including svg, png, jpeg, webp, and avif. The library offers ten distinct themes: light, dark, grafana, ant, vintage, walden, westeros, chalk, shine, and shadcn, with light as the default theme.

The library supports twenty-two chart types: Bar, HorizontalBar, Line, Pie, Radar, Scatter, Candlestick, Table, Heatmap, Funnel, Waterfall, MultiChart, Calendar, Gauge, Treemap, BoxPlot, Sunburst, Sankey, Tree, Graph, Parallel, and ThemeRiver. Drawing inspiration from Apache ECharts, charts-rs enables developers to create charts with similar functionality and appearance.

Themes

themes

Features

  • Ten built-in themes; custom themes supported via add_theme()
  • Custom font loading from ttf or otf files
  • Advanced line chart features: smooth curves, area filling, mark points and mark lines
  • Multiple legend styles across all charts: round rect, circle, and rect
  • Dual y-axis support via y_axis_configs and series.y_axis_index
  • Logarithmic scale support ("log", "log2", or {"type":"log","base":N})
  • Gradient fill for bars, areas, and pie slices (Fill::LinearGradient)
  • Per-series mixed chart types (bar + line on the same chart)
  • Series stacking, dash patterns, and per-bar custom colors
  • SVG animation support (duration, easing, stagger) for bar, line, pie, sunburst, funnel, treemap, and sankey charts
  • Null / missing data points via Option (null in JSON; legacy NIL_VALUE still accepted)
  • JSON-based chart configuration for all chart types
  • Multiple output formats: svg, png, jpeg, webp, avif
  • Scaled image export via svg_to_png_with_size and equivalent functions
  • Web-based JSON editor for interactive chart configuration and testing

Installation

Add charts-rs to your Cargo.toml:

toml
[dependencies]
charts-rs = "0.7"

SVG output works with the default build. Raster export (png, jpeg, webp, avif) — the svg_to_png, svg_to_png_with_size, and related functions used below — requires the image-encoder feature:

toml
[dependencies]
charts-rs = { version = "0.7", features = ["image-encoder"] }

Demo

You can try to use the web demo page, it's simple and useful.

Charts Web Demo Page: https://charts.npmtrend.com/

Charts Web Source: https://github.com/vicanso/charts-rs-web

Mix line bar

Horizontal bar

Line

Pie

Radar

Scatter

Candlestick

Table

Heatmap

Funnel

Waterfall

Calendar

Gauge

Treemap

Box Plot

Sunburst

Multi Chart

Example

Runnable examples live in examples/; each writes an svg file:

bash
cargo run --example bar       # basic bar chart
cargo run --example line      # smooth line with area fill and mark line / points
cargo run --example pie       # nightingale (rose) chart
cargo run --example sunburst  # sunburst with label formatter, ring thickness, animation
cargo run --example sankey     # sankey flow diagram (nodes auto-derived from links)
cargo run --example tree       # node-link tree with curved links (LR layout)

New from option

…

From json

…

Scaled image export

rust
use charts_rs::{BarChart, svg_to_png_with_size};
let chart = BarChart::from_json(r###"{ ... }"###).unwrap();
let svg = chart.svg().unwrap();

// Scale to exactly 800×400
let png = svg_to_png_with_size(&svg, Some(800), Some(400)).unwrap();

// Scale to width 800, preserve aspect ratio
let png = svg_to_png_with_size(&svg, Some(800), None).unwrap();

Null data points

Use null in JSON arrays to represent missing data; the chart skips rendering for those positions.

json
{
  "series_list": [{
    "name": "Sales",
    "data": [120.0, null, 101.0, null, 90.0]
  }]
}

In Rust, build the series with Option values (None is a missing point):

rust
use charts_rs::Series;
let series = Series::new_nullable(
    "Sales".to_string(),
    vec![Some(120.0), None, Some(101.0), None, Some(90.0)],
);
// or via the tuple conversion
let series: Series = ("Sales", vec![Some(120.0), None, Some(101.0)]).into();

The legacy NIL_VALUE sentinel (Series::new / Vec) still works and is treated as None.

Label formatters

Formatters are supported in series_label_formatter, axis_formatter, and value_formatter (GaugeChart).

Placeholder Meaning
{c} Data value
{a} Series name
{b} Category (x-axis label)
{d} Percentage (pie / funnel)
{t} Thousands notation (1.2K, 5.6M)

Load more fonts

rust
let buf = fs::read(file).unwrap();
add_fonts(&[&buf]).unwrap();

License

This project is licensed under the Apache-2.0 license.

Issues· 3 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rust

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 18, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言