npm包@csn_chile/wsjs_charts使用教程

阅读时长 5 分钟读完

在前端开发中,常常需要使用图表来展示数据,而 wsjs_charts 就是一个基于 Websocket 技术的图表库,通过使用该库,我们可以轻松地实现数据可视化。本篇文章将介绍如何使用 @csn_chile/wsjs_charts 这个 npm 库来在你的项目中实现图表。

安装

通过 npm 安装 @csn_chile/wsjs_charts:

如何使用

安装完成后你可以开始使用该库,这里有一个实现柱状图的示例:

-- -------------------- ---- -------
------ - -------- - ---- -------------------------

----- ---- - -
  - ----- ---- ------ -- --
  - ----- ---- ------ -- --
  - ----- ---- ------ -- --
  - ----- ---- ------ -- --
--

----- -------- - --- ----------
  -----
  ------- -------
  ------- --------
  ------ ------
  ------ ----
  ------- ----
  ---------- ------------------------------------------
---

这里我们首先从 @csn_chile/wsjs_charts 中导入 BarChart 类,然后我们准备要用来展示的数据,并将其作为参数传递到 BarChart 构造函数中。在这里,我们需要指定 xField 和 yField 作为数据的字段,以及图表的 title、width、height、container 等配置信息。最后将构造好的 barChart 实例添加到某个 HTML 元素上(本例子中是 id 为 chartContainer 的元素)。

现在你就可以看到一个漂亮的柱状图展示在界面中了!

API

下面是通过 BarChart 类所支持的配置项:

参数 说明 类型
data 图表数据,需要包含 xField 和 yField 两个字段 Array<object>
xField x 轴所对应的字段名 string
yField y 轴所对应的字段名 string
title 图表标题 string
width 图表宽度 number
height 图表高度 number
container 图表容器的 DOM 元素 HTMLElement
columnWidth 柱状图的宽度 number
padding 图表的外边距 { top: number, right: number, bottom: number, left: number }
xAxis x 轴的配置项 { ... }
yAxis y 轴的配置项 { ... }

除了 BarChart 之外,@csn_chile/wsjs_charts 还提供了 PieChart、LineChart 等其他类型的图表类。

结语

通过本篇教程,你应该已经掌握了如何使用 @csn_chile/wsjs_charts 这个 npm 库来创建数据可视化的图表。当然,这还只是出门了一步,你还可以进一步深入学习和掌握 @csn_chile/wsjs_charts 以及其他的前端可视化库,将其运用到日常开发中,从而提高自己的开发水平。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/csn-chile-wsjs-charts