DIV CSS 佈局教程網

D3.js 入門:從動態產生 p 標籤與條件式樣式說起
編輯:關於JavaScript     

D3 是以「資料驅動」為核心的可視化函式庫。理解它的關鍵不在畫圖,而在資料如何綁到 DOM 上。本文用一個最小的例子——產生幾段文字並依數值上色——把 select / selectAll / data / enter / append 這條鏈走一遍。

準備環境

建立一個 test 目錄,底下放兩個子資料夾:demo 存放要寫的 HTML,d3 存放 d3.v3.js。接著在 demo 中新增 indexP.html,貼入以下內容後直接用瀏覽器開啟即可。

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>D3: Setting paragraphs' style conditionally, based on data</title>
<script type="text/javascript" src="../d3/d3.v3.js"</script>
</head>
<body>
<script type="text/javascript">
var dataset = [ 5, 10, 15, 20, 25 ];
d3.select("body").selectAll("p")
  .data(dataset)
  .enter()
  .append("p")
  .text(function(d) { return "I can count up to " + d; })
  .style("color", function(d) {
    return d > 15 ? "red" : "black";
  });
</script>
</body>
</html>

這個 demo 做了三件事:在 body 中補上 p 標籤、填入由陣列來的文字,再依數值大小決定文字顏色。

鏈式呼叫逐一拆解

D3 大量使用「串接」寫法,把同一個物件上的連續操作串成一條線,可讀性與維護性都更好。

  • d3.select("body"):選取 body 元素,並把結果往下一個方法傳。
  • .selectAll("p"):選出所有段落。此時選到的集合是空的,這正是 D3 的設計——先宣告「我要對哪些元素操作」,再決定要補多少。
  • .data(dataset):把長度為 5 的陣列綁進來。從這裡往後的每個方法都會被執行 5 次,依陣列索引逐一對應元素。
  • .enter():為「資料有、DOM 不夠」的部分建立佔位元素。要建幾個,取決於既有標籤數與資料長度:本例 body 中原先沒有 p,所以建立 5 個;若原本已有 3 個,就只補 2 個,最終總數會等於 5。
  • .append("p"):把佔位元素落實成真正的 p 標籤。
  • .text(function(d) {}):決定每段顯示的文字,回傳字串。函式簽名固定寫成 function(d),d 就是綁定的那筆資料,這是 D3 取值的唯一入口。
  • .style("color", ...):設定樣式,和 text() 一樣可以傳入函式做條件判斷。本例數值大於 15 的段落變紅。

執行後可以看到五行文字,數值 20 與 25 那兩行是紅色的:

接著可以往哪走

把 body 裡的那段 JavaScript 想成「資料操作區」,之後絕大多數範例只要改這一段,外面的 HTML 骨架幾乎不動,這也是 D3 範例易於移植的原因。下一篇會談如何在 SVG 中畫圓,並用資料把多個圓連起來。

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