【 D3.js 高级系列 — 1.1 】 封装文本自动换行

在【高级 - 第 1.0 章】中讲解了在 SVG 中如何配合使用 text 和 tspan 来实现换行的功能,本文对此功能进行一下封装,以后就可以直接用了。


1. 引用 js 文件

下载地址:multext.js

下载之后,在 <script> 标签里引用:

<script src="multext.js" charset="utf-8"></script>

或者直接通过网址引用:

<script src="http://www.ourd3js.com/library/multext.js" charset="utf-8"></script>

当然,要使用此文件,同时要引用 d3 的库:

<script src="http://d3js.org/d3.v3.min.js" charset="utf-8"></script>

2. 函数的参数

文件里只实现了一个函数 appendMultiText(),其各参数的意义为:

appendMultiText(
	container,			//文本的容器,可以是<svg>或<g> 
	str, 				//字符串
	posX, 				//文本的x坐标
	posY, 				//文本的y坐标
	width, 				//每一行的宽度,单位为像素
	fontsize, 			//文字的大小(可省略),默认为 14
	fontfamily			//文字的字体(可省略),默认为 simsun, arial
)
 

3. 添加多行文本

下面添加多行文本试试。首先要添加<svg>元素:

		var width = 300;
		var height = 300;
		
		var svg = d3.select("body")
					.append("svg")
					.attr("width",width)
					.attr("height",height);

添加的<svg>元素,保存在变量 svg 中,这个变量要作为 appendMultiText 的参数使用。接下来添加多行文本:

var str = "青青子衿,悠悠我心,但为君故,沉吟至今。";			
						
appendMultiText(svg,str,30,100,120,20,"simsun");

代码的意思为:在 svg 容器里的坐标(30, 100)处添加指定字符串,每一行的长度为120个像素,超出的部分自动换行,字体大小为20,字体为宋体。结果如下:

111

可以看到,添加了四行文字,每行的长度为120个像素。appendMultiText自动为我们添加了<text >和<tspan>。

appendMultiText()的返回值是被添加的<text>元素的选择集,可以用一个变量保存此值,再做旋转平移之类的操作,当然也可更改字体等,例如:

var str = "青青子衿,悠悠我心,但为君故,沉吟至今。";			
						
var multext = appendMultiText(svg,str,30,100,120,20,"simsun");
				
multext.attr("transform","rotate(-20)");

文本逆时针旋转20度。

112

你还可以将文本放到<g>元素里。

var g = svg.append("g");
						
var multext = appendMultiText(g,str,30,100,120);

如此,多行文本的所有元素会置于<g>之下。上面这段代码的 appendMultiText() 省略了最后两个参数,如果省略,默认字体大小为 14px ,字体为 simsun, arial。

 

谢谢阅读。

文档信息

posted on 2015-03-12 10:19  三少爷的剑123  阅读(568)  评论(0编辑  收藏  举报

导航