npm 包 vega-hierarchy 使用教程

阅读时长 12 分钟读完

vega-hierarchy 是一个基于 Vega 数据可视化库的层次结构可视化工具。它能够解析嵌套的树形结构数据,然后基于该数据创建出相应的可视化图表。本文将详细介绍 vega-hierarchy 的使用方法,并带您运用起来。

安装

首先,您需要安装 vega-hierarchy。在命令行中运行以下命令:

这将在当前目录下安装 vega-hierarchy。您还需要在您的 HTML 文件中引入 Vega 库和 D3 库。在示例中,我们将使用最新版本的 Vega 和 D3 库。

创建数据

让我们首先创建一些示例数据。本例中,我们将创建一个嵌套的树形结构,表示一个组织机构:

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

创建视图

接下来,我们将创建一个 Vega 视图来呈现数据。以下是一个 Vega 视图的基本结构:

  • spec 是一个 Vega 规范。它定义了在视图中创建哪些图表,并如何从数据中映射视觉变量。您可以在官方文档中了解更多信息。
  • options 是一个可选的选项对象,其中包含在运行视图时使用的一些参数。
  • element 是一个 HTML 元素,它将呈现视图。

编写 Vega 规范

下一步是编写 vega-hierarchy 的 Vega 规范。以下是一个基本的 Vega 规范,用于呈现一个嵌套树形结构:

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

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

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

在这里,我们定义了一个 $500\times500$ 的视图,并将 orgData 数据集作为 tree 数据集装入 Vega 视图中。其中 stratify 操作是一个数据转换步骤,用于创建树形结构,而 tree 操作是一个数据转换步骤,用于计算树形布局的节点位置。linkpath 操作用于创建连接线的路径,而 symboltext 操作用于创建节点。

运行 Vega 视图

最后,我们将在一个 HTML 元素上呈现 Vega 视图。以下是完整的例子:

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

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

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

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

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

在本例中,我们使用 renderer: 'canvas' 来指定 Vega 使用 Canvas 渲染器呈现视图。还可以使用其他渲染器,例如 SVG 和 WebGL。

总结

在本文中,我们介绍了如何使用 npm 包 vega-hierarchy,并详细介绍了创建和运行 Vega 视图的步骤。此外,我们还提供了一个基于 vega-hierarchy 的示例,展示了如何处理嵌套的树形结构数据。我们希望您现在已经掌握了 vega-hierarchy 的基本知识,可以使用它来创建复杂的可视化图表。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eedd606bb4e78292a6fb87e

纠错
反馈