D3 已經是資料視覺化的主流工具之一,但初次接觸的人幾乎都會卡在這三個方法上:data()、enter()、exit()。原因之一是它們的命名看不太出具體在做什麼。本文用一連串對照範例把它們講清楚。
頁面上先有三個空的 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__ 驗證。綁定之後,後續就能用這些資料去決定寬度、文字等呈現。
如果 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")
下面的例子 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 裡,於是每一筆都得到一個對應元素。
與 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();
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()) 就能取代上面這整套分頭處理的寫法,語意也更接近「資料驅動」的本意。