D3.js 常用於繪製 SVG 圖表,但 SVG 的 text 元素本身不會像 HTML 段落那樣自動換行。若字串過長,就需要手動依寬度拆行,再透過 tspan 逐行輸出。
multext.js 提供了一個 appendMultiText 函式,只要傳入容器、字串、座標、行寬與字型設定,就能自動產生多行文本。
函式概念如下:
appendMultiText(container, str, posX, posY, width, fontsize, fontfamily)
其中 width 代表每行最大寬度,fontsize 與 fontfamily 可省略,未傳入時會使用預設值。
使用時要先建立 SVG 容器,再把容器、文字與排版參數傳入:
var svg = d3.select("body")
.append("svg")
.attr("width", 300)
.attr("height", 300);
var str = "青青子衿,悠悠我心,但為君故,沉吟至今。";
appendMultiText(svg, str, 30, 100, 120, 20, "simsun");
執行後,文字會依 120px 的行寬自動換行,並產生對應的 text 與 tspan 元素。

appendMultiText 會回傳 text 元素的選擇集,因此可以繼續串接 attr 或 transform,做旋轉、平移等進階處理。
var multext = appendMultiText(svg, str, 30, 100, 120, 20, "simsun");
multext.attr("transform", "rotate(-20)");

這個封裝適合需要大量文字註解的圖表,例如標籤、說明框與多行標題,能減少重複排版的工作。