# G2Plot
**Repository Path**: antv/g2plot
## Basic Information
- **Project Name**: G2Plot
- **Description**: 简单、易用、并具备一定扩展能力和组合能力的统计图表库,基于图形语法理论搭建而成
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://github.com/antvis/g2plot
- **GVP Project**: No
## Statistics
- **Stars**: 123
- **Forks**: 33
- **Created**: 2019-11-17
- **Last Updated**: 2025-06-15
## Categories & Tags
**Categories**: charting-components
**Tags**: None
## README
[English](./README.en-US.md) | 简体中文
G2Plot
基于 [G2 4.x](https://github.com/antvis/G2) 版本二次封装的图表库。
[](https://npmjs.com/@antv/g2plot)
[](https://npmjs.com/@antv/g2plot)

[](https://github.com/antvis/G2Plot/actions?query=workflow%3Abuild)
[](https://coveralls.io/github/antvis/G2Plot)
[](http://isitmaintained.com/project/antvis/g2plot "Percentage of issues still open")
[](http://isitmaintained.com/project/antvis/g2plot "Average time to resolve an issue")
> 📢 新版本 [G2 v5](https://github.com/antvis/G2) 已经发布,未来不会基于 G2 v5 封装 G2Plot v3 版本,但是可以使用 [Ant Design Charts](https://github.com/ant-design/ant-design-charts) 代替。
网站 •
快速开始 •
博客 •
AntV ThemeSet
一套简单、易用、并具备一定扩展能力和组合能力的统计图表库,基于图形语法理论搭建而成,『G2Plot』中的 G2 即意指图形语法 (the Grammar of Graphics),同时也致敬了 [ggplot2](https://ggplot2.tidyverse.org/)。我们想做的事有三件:
1. 使用户不用成为可视化专家也能够轻松制作出优雅美观的图表。
2. 保证图表能够经受得起业务的检验,在真实的场景中易用、好用。
3. 探索统计图表的更多可能性,使统计图表变得更好玩、更酷。
## ✨ 特性
### 📦 开箱即用、体验优雅的高质量统计图表
G2Plot 呈现给用户的是一套提炼自企业级产品的视觉语言和设计规范。不仅对图表的整体视觉样式进行了优化,并且针对每一个图表自身的特点,沉淀出一套最佳配置,保证用户能够通过最少的配置制作出优雅、标准的图表。
### 📊 响应式:让图表更聪明
在现实的图表应用场景中,一个棘手的难题是图表的展示空间往往并不足够显示图表的数据量,造成极值情况下文本的重叠遮挡、内容无法自适应、内容裁剪等问题。G2Plot 借鉴宽容性设计的思想,在图表的信息密度过高时,对图表辅助信息进行抽稀,保证图表主要信息的展示和基本可读性。
### 🔳 向前一步:会讲故事的图表
在 G2Plot 体系下,图表不仅仅只是各不相关的实例,图层概念的引入提供了多图表组合、叠加、联动,共同讲述一个数据故事的可能性。未来,我们还将探索统计图表转化信息图的可能性,丰富统计图表的表现能力。
## 📦 安装
```bash
$ npm install @antv/g2plot
```
## 🔨 使用
```html
```
```ts
import { Bar } from '@antv/g2plot';
const data = [
{ year: '1951 年', sales: 38 },
{ year: '1952 年', sales: 52 },
{ year: '1956 年', sales: 61 },
{ year: '1957 年', sales: 145 },
{ year: '1958 年', sales: 48 },
];
const bar = new Bar('container', {
data,
xField: 'sales',
yField: 'year',
seriesField: 'year',
});
bar.render();
```
## 🤝 参与贡献
我们非常欢迎你的贡献!无论是 issue 还是 PR。
反馈问题请先阅读 [issues](https://github.com/antvis/g2plot/issues)。
提交代码请遵循 [贡献指引](https://github.com/antvis/g2plot/blob/master/CONTRIBUTING.md)。
感谢下面这些贡献者 ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
## 🔗 相关链接
[ChartCube](https://chartcube.alipay.com/) - 基于 G2Plot 的在线图表制作工具,交互简单,一键导出图表代码!
## 许可证
MIT