百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
C

charts-rs

> 编程语言
开源

Rust 的图表库

316 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

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 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rust

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

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