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

G2Plot

基于图形语法（the Grammar of Graphics）的图表库。 [![Version](https://badgen.net/npm/v/@antv/g2plot)](https://npmjs.com/@antv/g2plot) [![NPM downloads](https://img.shields.io/npm/dm/@antv/g2plot.svg)](https://npmjs.com/@antv/g2plot) ![Latest commit](https://badgen.net/github/last-commit/antvis/G2Plot) [![build Status](https://github.com/antvis/G2Plot/workflows/build/badge.svg?branch=master)](https://github.com/antvis/G2Plot/actions?query=workflow%3Abuild) [![coverage](https://img.shields.io/coveralls/antvis/G2Plot/master.svg)](https://coveralls.io/github/antvis/G2Plot) [![Percentage of issues still open](http://isitmaintained.com/badge/open/antvis/g2plot.svg)](http://isitmaintained.com/project/antvis/g2plot "Percentage of issues still open") [![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/antvis/g2plot.svg)](http://isitmaintained.com/project/antvis/g2plot "Average time to resolve an issue")

网站 • 快速开始 • 博客 • 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)):

_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 💻	_嘤嘤嘤 💻	_琚致远 💻	₁₄ 💻

## 📧 联系我们钉钉群组号码: 30233731

## 🔗 相关链接

[ChartCube](https://chartcube.alipay.com/) - 基于 G2Plot 的在线图表制作工具，交互简单，一键导出图表代码！ ## 许可证 MIT