Skip to content
/ core Public

Qcharts是一个基于 spritejs 封装的图表库,可以让用户以组件的形式组合出各种图表

License

Notifications You must be signed in to change notification settings

qcharts/core

Repository files navigation

QCharts

特点

QCharts 是一个基于 spritejs 封装的图表库,它以数据驱动,将图表以最小组件进行拆分,具有高度全面灵活的属性配置方法,可对图表绘制过程中所有的点、线、面的大小、位置、填充颜色、描边颜色、描边线型、透明度等属性进行配置,配置方法简单易懂,语义清晰,无论如何复杂的图表,Qcharts 都能轻松胜任。 → 详细文档,Demo:Quickstart

安装

1.通过 npm 获取 QCharts,我们提供了 QCharts npm 包,通过下面的命令即可完成安装

npm install @qcharts/core --save
// 通过模块引入的方式使用CatCharts
import { Chart, Pie, Tooltip, Legend } from '@qcharts/core'

2.既可以下载脚本到本地,也可以通过 cdn 获取 QCharts;QCharts 依赖于 spritejs,需要先引入 spritejs。

<script src="https://unpkg.com/spritejs@3/dist/spritejs.min.js"></script>
<script src="https://unpkg.com/@qcharts/core@1/dist/index.js"></script>

开始使用

1.创建 div 图表容器,Qcharts 初始化 container 属性支持 id 选择器与 class 选择器

<div id="app"></div>

2.编写绘图代码

// 指定图表数据源
chart.source(data, {
  row: 'catgory', // 以catgory字段分组
  value: 'sales', // 以sales字段取值
  text: 'date' //  date为文本字段
})

// 创建折线对象
const line = new Line()
// 设置折线点的描边颜色为白色
line.style('point', { strokeColor: '#fff' })
// 创建提示框对象,格式化展示属性为:date scale
const tooltip = new Tooltip({
  formatter: function(data) {
    return `${data.date} ${data.sales}`
  }
})
// 创建底部坐标轴对象
const axisBottom = new Axis()
// 创建左侧坐标轴对象。隐藏轴体直线和刻度
const axisLeft = new Axis({ orient: 'left' }).style('axis', false).style('scale', false)
// 创建图例对象,设置位置以及图标和文本大小
const legend = new Legend({ align: ['center', 'bottom'] }).style('icon', { borderRadius: 10 }).style('text', { fontSize: 12 })
// 装载组件
chart.append([line, tooltip, axisBottom, axisLeft, legend])
// 渲染图表

一张折线图就绘制成功

在 React/Vue 中使用 Qcharts

基于 Qcharts 良好的组合性和扩展性,Qcharts 天然支持对 React 和 Vue 这两个常用框架的深度整合,在 React 环境下,我们推荐使用qcharts-react ,在 Vue 环境下,我们推荐使用 qcharts-vue。这两个产品都是基于 Qcharts 的封装,与 Qcharts 有着一致的开发体验,可以前往官网获取详细的使用说明和示例。当然,你可以自己动手封装成其他框架下的组件,在 Qcharts 下,这些封装成本非常低。

About

Qcharts是一个基于 spritejs 封装的图表库,可以让用户以组件的形式组合出各种图表

Resources

License

Stars

Watchers

Forks

Packages

No packages published