DIV CSS 佈局教程網

搞懂 D3.js 的 data()、enter() 與 exit()
編輯:關於JavaScript     

D3 已經是資料視覺化的主流工具之一,但初次接觸的人幾乎都會卡在這三個方法上:data()、enter()、exit()。原因之一是它們的命名看不太出具體在做什麼。本文用一連串對照範例把它們講清楚。

data():把資料綁到元素上

頁面上先有三個空的 p:

<body>
<p></p>
<p></p>
<p></p>
</body>

執行:

d3.select("body").selectAll("p").data([1, 2, 3])

表面上看不出任何變化,但 D3 內部已在每個 p 上掛了一個 __data__ 屬性,可以透過 document.getElementsByTagName("p")[0].__data__ 驗證。綁定之後,後續就能用這些資料去決定寬度、文字等呈現。

enter():為缺少的元素留位置

如果 DOM 元素比資料少,甚至一個都沒有呢?這次 body 裡是空的:

<body>
</body>

同樣執行:

d3.select("body").selectAll("p").data([1, 2, 3])

這時候不能再接 .style("width", "100px"),因為根本沒有選到元素。D3 的做法是讓 enter() 回傳一個「虛擬選擇集」——你可以把它想成佔位符,代表那些「資料有、元素還沒有」的部分。

關鍵觀念:enter() 只做選擇,不會真的建立元素,所以後面一定要接 append():

d3.select("body").selectAll("p").data([1, 2, 3]).enter().append("p")

enter 的典型處理方式

下面的例子 body 裡本來只有一個 p,資料卻有三筆:

<body>
<p></p>
<script>
var dataset = [3, 6, 9];
var p = d3.select("body").selectAll("p");

//綁定資料後,分別取得 update 與 enter 部分
var update = p.data(dataset);
var enter  = update.enter();

//update 部分:直接改內容
update.text(function(d){ return d; });

//enter 部分:先補上元素再改內容
enter.append("p").text(function(d){ return d; });
</script>
</body>

enter 部分包含了多出来的兩筆資料,處理方式就是 append 對應的 p,最後 body 裡有三個段落:

<p>3</p>
<p>6</p>
<p>9</p>

更常見的情況是「資料已經從伺服器讀到了,但網頁上一個元素都沒有」。這正是 D3 很重要的一個特性——允許你選一個空集,再用 enter().append() 插入元素:

var dataset = [10, 20, 30, 40, 50];
var body = d3.select("body");

body.selectAll("p")   //沒有 p,於是選到空集
    .data(dataset)    //綁定資料
    .enter()          //取得 enter 部分
    .append("p")      //為每筆資料補上 p
    .text(function(d){ return d; });

因為選擇集是空的,data() 回傳的 update 部分也是空的,全部資料都落在 enter 裡,於是每一筆都得到一個對應元素。

exit():清掉多餘的元素

與 enter 相反,exit() 選的是「元素比資料多」多出來的那一批。這次 body 裡有四個 p:

<body>
<p></p>
<p></p>
<p></p>
<p></p>
</body>

因為多出來的是實際存在的元素,所以最後一個 p 就是 exit 部分,接著用 remove() 移除即可:

d3.select("body").selectAll("p").data([1, 2, 3]).exit().remove();

exit 的典型處理方式

var dataset = [10, 20, 30];
var p = d3.select("body").selectAll("p");

var update = p.data(dataset);
var exit   = update.exit();

//update 部分:改內容
update.text(function(d){ return d; });

//exit 部分:刪除多餘元素
exit.remove();

執行完之後,頁面不會留下沒有資料對應的 p。

一句話總結

把 data() 想成一次「比對」:它把資料與現有元素對齊,於是自然分成三堆——數量吻合的 update、資料多於元素的 enter、元素多於資料的 exit。D3 官方早期的 Thinking with Joins(Mike Bostock 著)把這個思考模型講得最透澈,值得一读。

D3 v5 之後加入了 join(),一句 selection.join(enter => enter.append("p"), update => update, exit => exit.remove()) 就能取代上面這整套分頭處理的寫法,語意也更接近「資料驅動」的本意。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved