d3从入门到出门

前言

基于d3js 5.5版本基础教程

环境配置

下载最新d3js文件, 参考: d3js官网

当前版本5.5, d3js v4与v3之间的api有一定的差异。

选择元素

d3主要有两个选择器

• select

  选择相应的dom元素, 如果有多个, 选择第一个

• selectAll

  选择所有的指定的dom元素.

通过选择器可以选择相应得dom元素, 而选择器的语法基本就是css选择器的语法.

css选择器语法: http://www.w3school.com.cn/c***ef/css_selectors.asp

增删查改

假设网页有以下元素, 关于d3的元素操作都将引用本段落

// 省略html,head等标签

    
    
段落1
    
段落2
    
段落3
    

元素增加

• append

  在选择的元素中增加一个子元素,

  示例: 
  d3.select("body").append("p") //将会在svg后面增加一个内容为空的p元素

• insert

  在选择的元素里面或者前面增加一个元素,

  示例1:
  d3.select("body").insert("p") //与append方法一致
  
  示例2:
  d3.select("body").insert("p", "p") //第一个参数为要插入的元素, 第二个元素为before, 即首先通过第二个参数选择相应位置，在这个选择的元素之前插入一个元素
  

  内容修改

• text

  修改元素的文本内容

  示例:
  d3.select("p").text("段落一修改后的内容") // 将段落一的内容修改为text函数传入的参数，如果传入的文本包含html标签，则会被转义

• html

  修改元素内容

  示例:
  d3.select("p").html("
  段落一修改后的内容
  ") // 将段落一的内容修改为text函数传入的参数，如果传入的文本包含html标签，不会被转义

属性增加修改

• attr

  增加或者修改属性(如果属性已存在)

  示例:
  d3.select("svg rect").attr("width", 200) //将选择的rect元素width属性修改为200

• style

  增加或这修改样式(如果属性已存在)

  示例:
  d3.selectAll("p").style("color", "#ff0000") //选择所有p元素，并将其文字颜色设置为红色

• property

  增加或这修改样式(如果属性已存在)

  示例:
  d3.select("input").property("checked",true); //选择第一input元素，将checked属性设置为true

元素删除

• remove

  将选定的元素删除

  示例:
  d3.select("p").remove //选择第一个p元删除

链式操作

d3与jQuery有一样的链式操作, 只要操作合法你可以一直链接下去

示例:
//首先选择第一个p元素然后将元素的文本内容修改为'修改后内容',并将其文字颜色设置为红色
d3.select("p")
  .text("修改后内容")
  .style("color", "red") 

数据绑定与加载

数据绑定

• datum

  将一个数据绑定到所有选择的元素上

  // 通过datum元素将"datum"数据传入, 在text方法里面传入一个箭头函数，而箭头函数直接返回数据
  d3.selectAll("p")
    .datum("datum")
    .text((d, i) => d)
  
  // 修改后的内容如下
  ...省略不相内容
  datum
  datum
  datum

• data

  传入一组数据，分别于选择的元素一一绑定

  // 通过datum元素将"datum"数据传入, 在text方法里面传入一个箭头函数，而箭头函数直接返回数据
  d3.selectAll("p")
    .data([1,2,3])
    .text((d, i) => d)
  
  // 修改后的内容如下
  ...省略不相关内容
  1
  2
  3

• update, enter, exit

参考图片内容:

网络数据加载

d3内置数据加载的方法，可以解析比较常见的数据格式，主要有以下四种，这里主要以csv文件个数数据作为示例

• d3.csv
• d3.json
• d3.tsv
• d3.xml

csv文件内容如下
//data.csv
name, age
zhangsan, 11
wangwu, 22
lisi, 33

// 加载csv
d3.csv("data.csv", (data) => {
    console.log(data)
})

// 输出, d3已经将csv格式的数据解析成可识别的对象
{name: "zhangsan", " age": " 11"}
{name: "wangwu", " age": " 22"}
{name: "lisi", " age": " 33"}

事件

d3自然也可以监听相应的事件。
常用事件如下:

// 选择所有的p元素，当鼠标移到相应的p元素上面，p元素的字体颜色就会变成橙色，移出的时候就会变成红色
d3.selectAll("p")
      .on("mouseover", function(){
          d3.select(this)
            .style("color", "orange");
      })
      .on("mouseout", function() {
        d3.select(this)
            .style("color", "red");
      })

动画

可以通过以下四个过程使得选定的元素生成动态效果

• transition

  启动动画效果

• duration

  动画时间，单位为毫秒

• ease

  过渡方式, 默认为线性过渡

• delay

  延迟时间，在指定的一段时间后才启动动画

// 选中第一个元素，先延迟延迟一秒，动画时间2秒，在两秒内同时从默认的颜色渐变到红色，字体大小从默认大小变成50px
d3.select("p")
      .transition()
      .delay(1000)
      .duration(2000)
      .style("background-color", "red")
      .style("font-size", "50px")

缩放

由于使用的数值与图片中的长宽数值有一定的差异，比如，图片长度为500，但是数值都是在10以内, 我们做出来的图一定是需要尽量的填充整个视图，所以需要对源数据做一定的缩放, 下面介绍两类缩放，d3本身有很多的缩放函数。

线性缩放

var data = [100, 400, 300, 900, 850, 1000];

var scale = d3.scaleLinear()
            // 源数据数值范围
            .domain([0, d3.max(data)])
            // 真实距离大小范围，一般是展示区长宽
            .range([0, 500]);
console.log(scale(20))
console.log(scale(800))
console.log(scale(1000))

输出
10
400
500

离散缩放

// 常用于选区颜色
var index = [0, 1, 2, 3, 4]
var color = ["red", "blue", "green", "yellow", "black"]
var ordinal = d3.scaleOrdinal()
                .domain(index)
                .range(color)
console.log(ordinal(1))
console.log(ordinal(4))
console.log(ordinal(100))

//输出
blue
black
blue

坐标轴

常见图标展示一般都会带有坐标轴，因为坐标轴是一个很常用的功能，所以d3有内置的函数用于生成坐标轴

可选坐标轴

• axisTop
• axisRight
• axisBottom
• axisLeft

上面的上下左右主要指坐标周的刻度文字的位置，比如axisTop是指文字在横轴上面

var width = 400,
    height = 100;

var data = [10, 15, 20, 25, 30];

// 在body元素内插入一个svg元素 
var svg = d3.select("body")
            .append("svg")
            .attr("width", width)
            .attr("height", height);

// 创建一个线性缩放函数
var scale = d3.scaleLinear()
              .domain([d3.min(data), d3.max(data)])
              .range([0, width - 100]);

// 创建一个坐标轴，需传入缩放函数
var x_axis = d3.axisBottom()
               .scale(scale);

//在svg函数里面加入一个g元素，并创建坐标轴
svg.append("g")
   .call(x_axis);

坐标轴微调

//旋转坐标轴文字
d3.selectAll("svg > g  text")
  .attr("transform", "rotate(45)")
  // 文字沿当前方向距离轴位置大小
  .attr("y", 20)

柱状图

柱状图示例
参考: http://www.tutorialsteacher.com/d3js/create-bar-chart-using-d3js

饼图

参考: http://www.tutorialsteacher.com/d3js/create-pie-chart-using-d3js

后记

之所以叫做从入门到出门, 是因为本人学得很快, 忘得更快。

参考链接

https://d3js.org/
http://www.tutorialsteacher.com/d3js
http://www.ourd3js.com/wordpress/396/