G2Plot

An interactive and responsive charting library

README

[English](./README.en-US.md) | 简体中文

G2Plot


基于图形语法(the Grammar of Graphics)的图表库。
Version NPM downloads
Latest commit build Status coverage Percentage of issues still open Average time to resolve an issue

网站快速开始博客AntV ThemeSet


一套简单、易用、并具备一定扩展能力和组合能力的统计图表库,基于图形语法理论搭建而成,『G2Plot』中的 G2 即意指图形语法 (the Grammar of Graphics),同时也致敬了 ggplot2。我们想做的事有三件:

1. 使用户不用成为可视化专家也能够轻松制作出优雅美观的图表。
2. 保证图表能够经受得起业务的检验,在真实的场景中易用、好用。
3. 探索统计图表的更多可能性,使统计图表变得更好玩、更酷。


✨ 特性


📦 开箱即用、体验优雅的高质量统计图表


G2Plot 呈现给用户的是一套提炼自企业级产品的视觉语言和设计规范。不仅对图表的整体视觉样式进行了优化,并且针对每一个图表自身的特点,沉淀出一套最佳配置,保证用户能够通过最少的配置制作出优雅、标准的图表。


📊 响应式:让图表更聪明


在现实的图表应用场景中,一个棘手的难题是图表的展示空间往往并不足够显示图表的数据量,造成极值情况下文本的重叠遮挡、内容无法自适应、内容裁剪等问题。G2Plot 借鉴宽容性设计的思想,在图表的信息密度过高时,对图表辅助信息进行抽稀,保证图表主要信息的展示和基本可读性。


🔳 向前一步:会讲故事的图表


在 G2Plot 体系下,图表不仅仅只是各不相关的实例,图层概念的引入提供了多图表组合、叠加、联动,共同讲述一个数据故事的可能性。未来,我们还将探索统计图表转化信息图的可能性,丰富统计图表的表现能力。


📦 安装


  1. ``` sh
  2. $ npm install @antv/g2plot
  3. ```

🔨 使用



  1. ``` html
  2. <div id="container"></div>
  3. ```

  1. ```ts
  2. import { Bar } from '@antv/g2plot';

  3. const data = [
  4.   { year: '1951 年', sales: 38 },
  5.   { year: '1952 年', sales: 52 },
  6.   { year: '1956 年', sales: 61 },
  7.   { year: '1957 年', sales: 145 },
  8.   { year: '1958 年', sales: 48 },
  9. ];

  10. const bar = new Bar('container', {
  11.   data,
  12.   xField: 'sales',
  13.   yField: 'year',
  14.   seriesField: 'year',
  15. });

  16. bar.render();
  17. ```

🤝 参与贡献


我们非常欢迎你的贡献!无论是 issue 还是 PR。

反馈问题请先阅读 issues

提交代码请遵循 贡献指引

感谢下面这些贡献者 (emoji key):





Visiky

💻

hustcc

💻

Joel Alan

💻

刘珍莹

💻

zqlu

💻

arcsin1

💻

被雨水过滤的空气

💻

banli

💻

xi li

💻

DarrenPei

💻

MiniPear

💻

connono

💻

于向前

💻

afc163

💻

Martin Jul

💻

jhwong

💻

Jingsong Gao

💻

Mr小刘

💻

ntscshen

💻

yiminanci

💻

ai-qing-hai

💻

xrkffgg

💻

Dawnlck

💻

Karis

💻

Mayne

💻

Plortinus

💻

Shanjie Chen

💻

Yang Libin

💻

beewolf233

💻

lqzhgood

💻

neoddish

💻

stack-stark

💻

vector

💻

嘤嘤嘤

💻

琚致远

💻

14

💻






📧 联系我们


钉钉群组号码: 30233731 / 35686967 (2 群) / 44788198 (3 群)


🔗 相关链接


[ChartCube](https://chartcube.alipay.com/) - 基于 G2Plot 的在线图表制作工具,交互简单,一键导出图表代码!

许可证


MIT