DIV CSS 佈局教程網

D3.js 文本自動換行封裝:multext.js 與旋轉平移應用
編輯:關於JavaScript     

為什麼需要自動換行

D3.js 常用於繪製 SVG 圖表,但 SVG 的 text 元素本身不會像 HTML 段落那樣自動換行。若字串過長,就需要手動依寬度拆行,再透過 tspan 逐行輸出。

multext.js 封裝

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)");

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

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