可视化 — D3学习笔记小小案例记录一下

D3全称是Data-Driven Documents数据驱动文档,是一个开源的javascript库,可以用于数据可视化图形的创建,该库更接近底层,与 g2、echarts 不同,d3 能直接操作 svg,所以拥有极大的自由度,几乎可以实现任何 2d 的设计需求。
正如其名 Data Driven Documents,其本质是将数据与 DOM 绑定,并将数据映射至 DOM 属性上,D3扮演的是一个驱动程序的角色,联系着数据和文档。

与echarts 相比,D3.js 不会生成事先定义好的图表,而是提供一些方法用来生成带数据的标签,绑定可视化的属性,由自己定义如何制作图表,还提供很多数据处方法,可以更好的显示的数据模型。echarts 可以提供更方便的图表组件,满足大部分的需求,D3.js 可以提供更丰富的自定义功能,适合定制化。

学习D3.js 更多的时候是学习它如何加载、绑定数据、数据处理、变换和过渡等这些方法的过程,而且D3.js 用了一种与 jQuery 一样的 链式语法。官方文档的 API 非常的多,本文也只是小小的记录一下项目实现。功能比较简单,做个记录。

下载依赖包: npm install d3 d3-graphviz@4
App.vue

<template>
  <div id="app">
    <Graph :code="jsonToDot()"/>
  </div>
</template>

<script>
import Graph from "./components/Graph";   // 封装了一个子组件
export default {
  data() {
    return {
      dot: JSON.stringify({   // 测试数据
         foo: ["bar", "buzz"],
        bar: ["foo"],
        norf: ["bar", "buzz"],
        worf: ["a"],
        fizz: ["buzz"],
        worble:["norf","buzz"],
        buzz:["norf","worf"],
        a:["b","c"],
        b:["d","f"]
      })
    };
  },
  components: {
    Graph
  },
  methods: {
    jsonToDot() {  // 处理数据格式为 插件可以解析的格式
      const json = JSON.parse(this.dot);
      return (   
        Object.entries(json).reduce((acc, [node, dependencies]) => {
          return dependencies.reduce(
              /**
              * 此处为单个节点关系,设置样式
              * arrowsize: 箭头尺寸
              * color:连接线的颜色
              * style:节点边框形状,rounded 圆角
              */
            (acc, dependency) => acc + `  "${node}" -> "${dependency}"\n [arrowsize=.4, color=grey, style="rounded"]`,
            acc
          );
           /**
           * 此处设置graph图所有点线关系的统一样式
           * ranksep: node之间的间距
           * graph - rankdir: 布局方向,LR从左到右,TB从上到下(默认)
           * graph - bb: 以点为单位的绘图边界框
           * node - margin: 节点内边距
           * node - shape: 节点形状
           * node - height: 节点高度
           * node - style:  节点样式,圆角,填充色
           * node - color:  颜色
           * node - fillcolor:  背景填充色
           * edge - style: 连线样式 solid实线
           * edge - arrowhead: 连线箭头样式
           * edge - arrowtail: 连线箭尾样式
           * ......
           * 还有很多属性,可参考下方提供的参考文档
           */
        },`digraph G { ranksep = 2.0; graph [rankdir=LR,bb="0,0,412.05,372.8"];node [margin=".3,.1",shape=box,height=.3, style="rounded,filled", color="lightgreen", fillcolor="lightgreen"]; edge [style=solid,arrowhead=normal,arrowtail=dot,]; \n`) + "}"
      );
    }
  }
};
</script>

Graph.vue: 其中/@hpcc-js/wasm/dist/index.min.js该文件服务器地址不是很稳定,建议下载下来,存在自己项目的服务器上。

<template>
  <div>
    <script src="https://unpkg.com/@hpcc-js/wasm/dist/index.min.js" type="javascript/worker"/>
    <div id="graph"/>
  </div>
</template>
<script>
import * as d3 from 'd3'
import * as d3Graphviz from 'd3-graphviz'
export default {
  props: {
    code: {
      type: String,
      default:  `digraph G {
            node [shape="record"];
            edge [style="dashed"];
            a -> b
          }`
    }
  },
  methods: {
   render() {
      // scale 缩放比例
      // fit(true) 自适应缩放,当节点比较多时可以显示完成的图,但是会看不清楚,节点较少时,会很大,慎用!!默认值false
      d3Graphviz.graphviz("#graph").width(window.innerWidth).height(1500).scale(0.8).attributer(function (d) {
        // 当节点非常多时,默认将主节点调至视口中间。 适用于数据量差不多的数据,统一调整图表视口,否则数据较少时,图表上移可视窗口会看不见
        /* const px2pt = 3 / 4;
        * if (d.tag === 'svg') {
        *   var selection = d3.select(this);
        *   var width = d.attributes.width;
        *   var height = d.attributes.height;
        *   var w = d.attributes.viewBox.split(" ")[2];
        *   var h = d.attributes.viewBox.split(" ")[3];
        *   var x = (width - w) / 3;
        *   var y = height;
        *   console.log(width, height, w, h, x, y, width * px2pt, height * px2pt);
        *   //   selection.attr("viewBox", -x + " " + y + " " + w + " " + (height * px2pt));
        *   d.attributes.viewBox = 0 + " " + 0 + " " + w + " " + h;
        *  }
        */
        // 当节点非常多时,默认将主节点调至视口中间。比例是我自己估算的, 适用于数据数量不确定,相差较大的数据
        const childNum = 8 / 5;
        if (d.tag === 'g' && d.parent.tag == 'svg') {
          if (d.children.length > 500) {
            d.translation.y = d.children.length * childNum
          }
        }
      }).renderDot(this.code)
    }
  },
  mounted() {
    this.render();
  },
  watch: {
    code() {
      this.render();
    }
  }
};
</script>

实现效果图:

官方文档:

Graphviz

d3-graphviz

官方案例参考 D3 Graphviz Examples:

案例列表: https://codesandbox.io/examples/package/d3-graphviz
本人参考案例:https://codesandbox.io/s/graph-viz-ltx0q-ltx0q?file=/src/App.vue

posted on 2023-01-02 21:30  漫思  阅读(94)  评论(0编辑  收藏  举报

导航