在 D3.js 中建立 SVG 文字時,若字串長度超過 SVG 寬度,超出部分會被裁切。此時需要手動把文字拆成多行。
例如先建立一個 300px 見方的 SVG:
var svg = d3.select("body")
.append("svg")
.attr("width", 300)
.attr("height", 300);
若直接放入長句,文字會超出可視範圍。

SVG 的解法是在 text 中加入多個 tspan,每個 tspan 代表一行。透過 dy 屬性設定相對位移,再用 x 屬性對齊左側,就能排出整齊的多行文字。
D3 的實作方式,是先把字串以分隔符拆成陣列,再把資料綁定到 tspan:
var strs = str.split(",");
text.selectAll("tspan")
.data(strs)
.enter()
.append("tspan")
.attr("x", text.attr("x"))
.attr("dy", "1em")
.text(function(d) { return d; });
完成後,原本的一行長文就會依逗號拆成多行,並在 SVG 中垂直排列。

這種做法的核心有兩個:第一,將字串切成適合每行的片段;第二,用 tspan 與 dy 控制行距。若要更精細地依像素寬度換行,則需要計算每個字元或字詞的寬度,再動態決定斷行位置。