在前端开发中，我们经常需要对数据进行可视化展示。而 npm 包 @modulr/display 则提供了一种简单易用的方式，使我们能够快速地创建交互式的数据可视化。本文将介绍 @modulr/display 的基础用法以及一些常见的高级功能。
@modulr/display 的安装
在使用 @modulr/display 前，你需要在项目中安装它。
npm install @modulr/display --save
@modulr/display 的基本用法
创建基本图表
首先，你需要创建一个容器，用于放置图表。
<div id="chart-container"></div>
然后，在 JavaScript 中，你需要引入 @modulr/display，并创建一个 chart 实例，最后调用 chart 的 render 方法即可。
-- -------------------- ---- -------
------ - ----- - ---- ------------------
----- ---- - -
- ---- --------- ------ --- --
- ---- ---------- ------ --- --
- ---- ------------ ------ --- --
- ---- ----------- ------ --- --
- ---- --------- ------ --- --
- ---- ----------- ------ --- --
- ---- --------- ------ --- --
--
----- ----- - --- ------------------------- -
----- ------
----- -
------- ------------- -- ----------
--------- --
----- --------
----- ------------- -- ------------
---
--
---
---------------上面的代码中，我们使用了 @modulr/display 中的 Chart 类来创建一个柱状图。通过传入一个容器的选择器和图表配置，我们创建了一个 chart 实例。其中，data 属性是一个包含数据信息的对象，可以根据实际情况进行设置。
修改图表样式
除了数据以外，你还可以通过 CSS 样式来修改图表的外观。
<style>
.modulr-chart {
font-family: 'Helvetica Neue', sans-serif;
font-size: 16px;
color: #333;
}
</style>添加交互行为
@modulr/display 还提供了多种交互式行为，使你能够更加自由地操作图表。例如，你可以添加鼠标悬停事件来显示鼠标所在位置的值。
-- -------------------- ---- -------
----- ----- - --- ------------------------- -
----- ------
----- -
------- ------------- -- ----------
--------- --
----- --------
----- ------------- -- ------------
---
--
-------- -
-------- ----- ----- -- -
-- ------ -
------------------- ----------------
-
--
--
---在上面的代码中，我们使用了 Chart 实例的 options 属性来设置图表的选项。其中，onHover 属性是一个函数，用于处理鼠标悬停事件。该函数接收两个参数：evt 和 item，分别代表事件对象和悬停的图表元素。
导出图表
最后，如果你需要将图表导出为图片或者 PDF，@modulr/display 也提供了对应的方法。
chart.export().then(url => {
const link = document.createElement('a');
link.href = url;
link.download = 'chart.png';
link.click();
});在上面的代码中，我们调用了 Chart 实例的 export 方法将图表导出。该方法会返回一个 Promise，resolve 值为导出的二进制数据的 URL。我们可以将该 URL 赋值给包含 download 属性的链接元素以便用户下载图表。
@modulr/display 的高级用法
除了基础用法以外，@modulr/display 还支持多种高级用法。下面我们将介绍其中的一些。
自定义组件
@modulr/display 允许你自定义组件以便更好地满足你的需求。例如，你可以创建一个自定义 tooltip 组件，使用户在鼠标悬停时能够看到更详细的信息。
-- -------------------- ---- -------
----- ------- - --- ---------
--------------- ------ -
-- -------------- -
----- ---- - ---------
------ --------------- ---------------
-
--
---
----- ----- - --- ------------------------- -
----- ------
----- -
------- ------------- -- ----------
--------- --
----- --------
----- ------------- -- ------------
---
--
----------- ----------
---在上面的代码中，我们创建了一个自定义 tooltip 组件，并使用 Chart 的 components 选项将它添加到了 chart 实例中。
动画效果
@modulr/display 提供了多种动画效果，使你的图表看起来更加生动。例如，你可以为柱状图添加一个渐变动画效果。
-- -------------------- ---- -------
----- ----- - --- ------------------------- -
----- ------
----- -
------- ------------- -- ----------
--------- --
----- --------
----- ------------- -- ------------
---
--
-------- -
-------- -
--------- -----
------- --------------
--
--
---在上面的代码中，我们使用了 Chart 实例的 options 属性，并为其添加了 animate 属性。该属性包含了动画的配置信息，其中 duration 表示动画的持续时间，easing 表示动画的缓动函数。
多语言支持
@modulr/display 支持多种语言，使你能够将图表展示给全球用户。例如，你可以将图表的文本设置为中文。
-- -------------------- ---- -------
----- ----- - --- ------------------------- -
----- ------
----- -
------- ------------- -- ----------
--------- --
----- ------
----- ------------- -- ------------
---
--
--------- -
----- -
------ -----
--
------ --------
--
---在上面的代码中，我们使用了 Chart 实例的 language 属性，并为其添加了中文的语言配置信息。
总结
@modulr/display 是一款高效简单的数据可视化工具，其提供了多种基础用法及高级功能，让你的数据更加生动易懂。希望本文能帮助你快速掌握 @modulr/display 的使用方法，为你的项目提供帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60055b0f81e8991b448d8b7c