网络拓扑图上文本的巧妙应用
在前端网页设计中，文本是重要的组成部分，那么在网络拓扑图中也是一样的，文本在网络拓扑图上最基本的显示功能之一，在不同的应用场景下，会有不同的需求。但是不同的需求也逃不过一些基础设置，如位置、旋转、字体、颜色等需求。接下来我们就来详细聊聊 HT for Web 中文本的相关应用。
HT for Web 为网络拓扑图上的节点提供了两个文本，也确实需要两个文本同时存在的情况，比如车站上面的站牌，就有汉字和拼音的组合，如果做一个公交站示意图的话，节点上的两个文本就都用得上了。今天就模拟一个地铁站点和大家一起聊聊网络拓扑图上的文本应用。
在前端网页设计中，文本是重要的组成部分，那么在网络拓扑图中也是一样的，文本在网络拓扑图上最基本的显示功能之一，在不同的应用场景下，会有不同的需求。但是不同的需求也逃不过一些基础设置，如位置、旋转、字体、颜色等需求。接下来我们就来详细聊聊 HT for Web 中文本的相关应用。
HT for Web 为网络拓扑图上的节点提供了两个文本，也确实需要两个文本同时存在的情况，比如车站上面的站牌，就有汉字和拼音的组合，如果做一个公交站示意图的话，节点上的两个文本就都用得上了。今天就模拟一个地铁站点和大家一起聊聊网络拓扑图上的文本应用。
今天拿来说明的 Demo 链接：http://www.hightopo.com/demo/label/index.html
从上图可以看出，文本有各种各样的需求，有可能还有其他更复杂的需求，在这边我就抽取几种需求来具体描述下，那我们一步一步来调效果，先从厦门这个站点开始吧。
node.s({ \'label\': \'厦门\', \'label2\': \'Xiamen\' });
网络拓扑图的创建及节点的创建我这边就不再多描述了，我们直奔主题，先设置 Node 上面的两个文本看看效果。
如上图，可以发现连个文本是在 Node 上不同的位置，显然这样子不是我们想要的效果，那文本的位置又该怎么去定义呢？这时就需要移步到我们的《位置手册》（http://www.hightopo.com/guide/guide/core/position/ht-position-guide.html）来了解相关的设置及含义。在我们的风格手册中的 ht.Style 章节有描述 label 和 label2 的位置默认值，label.position 的默认值是 31，label2.position 的默认值是 34，在位置手册中找到两个 label 需要摆放的位置，然后设置到 Node 上就可以了。那么根据前面总体效果图中的厦门站点，可以发现两个 label 的位置都是在中下方，所以两个 lable 的 position 都应该设置为 31，当设置两个文本的 position 都为 31 的话，会发现连个文本是重叠的，这肯定不是我们想要的效果。仔细阅读风格手册，会发现连个 label 都有 offset.x 和 offset.y 连个属性，这两个属性很好理解，就是用来设置文本的偏移值的。
node.s({ \'label\': \'厦门\', \'label2\': \'Xiamen\', \'label2.position\': 31, \'label2.offset.y\': 15 });
我们对 label2 设置了 position 属性为 31，和 label 的 position 属性默认值一样，并且设置了 label2 的 offset.y 属性，让 label2 向下便宜 15 个像素。
上图的文本位置看起来舒服多了，但是感觉还是不对，没有主次之分，是不是应该将 label 的文本大小设置大一点，别让拼音抢了风头，两个文本都有 font 属性可以设置，而且默认值都是 12px arial, sans-serif。
node.s({ \'label\': \'厦门\', \'label.font\': \'22px arial, sans-serif\', \'label2\': \'Xiamen\', \'label2.position\': 31, \'label2.offset.y\': 23 });
我们将 label 的 font 属性适当地讲字体调大了，自然 label2 的偏移值也需要做些调整，不然两个文本就又叠在一起了。
上图的效果看着顺眼多了。
看上图，我们又多搞了几个 label 样式，和前面的 label 参数差不多，就中间的两个文本样式多了个 rotation，还有一个文本换行。
var list = [], node; for (var i = 0; i < 4; i++) { node = new ht.Node(); node.setImage(\'station\'); node.p(100 + i * 100, 100); dm.add(node); list.push(node); } node = list[0]; node.s({ \'label\': \'厦门\', \'label.font\': \'22px arial, sans-serif\', \'label2\': \'Xiamen\', \'label2.position\': 31, \'label2.offset.y\': 23 }); node = list[1]; node.s({ \'label\': \'图\n扑\', \'label.position\': 14, \'label.font\': \'22px arial, sans-serif\', \'label2\': \'Hightopo\', \'label2.position\': 14, \'label2.offset.x\': -7, \'label2.rotation\': -Math.PI / 2 }); node = list[2]; node.s({ \'label\': \'上\n海\', \'label.position\': 20, \'label.font\': \'22px arial, sans-serif\', \'label2\': \'Shanghai\', \'label2.position\': 20, \'label2.offset.x\': 6, \'label2.rotation\': -Math.PI / 2 }); node = list[3]; node.s({ \'label\': \'北京\', \'label.position\': 3, \'label.font\': \'22px arial, sans-serif\', \'label2\': \'Beijing\', \'label2.position\': 3, \'label2.offset.y\': -23 });
从上面的代码可以看到，在“图扑”和“上海”两个节点的 label 都加了“\n”回车转义字符，在 HT 的内部实现中，有对“\n”回车转义字符做解析处理，让文本在表现上可以换行显示。
最后就是站点之间的连线处理了，连线可以通过设置 Edge 的样式 edge.points 和 edge.segments 两个属性来实现，在我们的《入门手册》（http://www.hightopo.com/guide/guide/core/beginners/ht-beginners-guide.html#ref_styleedge）中有说明其具体用法，可以一步阅读，这不是今天的重点，在这边就不详细说明了。
var bj_sh = new ht.Edge(bj, sh); bj_sh.s(cloneObj(edgeStyle, { \'edge.points\': [ { x: 280, y: 50 }, { x: 280, y: 100 }, { x: 280, y: 150 } ], \'edge.segments\': [1, 3, 3] })); dm.add(bj_sh); var sh_xm = new ht.Edge(sh, xm); sh_xm.s(cloneObj(edgeStyle, { \'edge.points\': [ { x: 500, y: 150 }, { x: 200, y: 450 } ], \'edge.segments\': [1, 4] })); dm.add(sh_xm); var xm_tp = new ht.Edge(xm, tp); xm_tp.s(cloneObj(edgeStyle, { \'edge.points\': [ { x: 70, y: 430 }, { x: 100, y: 400 } ], \'edge.segments\': [1, 4] })); dm.add(xm_tp);
如上代码，通过 Edge 将节点连接起来，并设置其 edge.points 和 edge.segments 两个样式，从而达到文章开头的示意图那样的效果，当然站点也是需要设置到相应的位置。在这边需要注意的是，edge.points 属性是没有包含起点和终点的，所以，你可以看到上图中的代码，按照 edge.segments 属性计算出来的点个数和 edge.points 的数组个数是不一样的，而且总是相差 2。
虽然源码不长，但是由于篇幅的原因，这里就不贴源码了，感兴趣的同学可以到我们的官网上查看 Demos 的源码，Demo 的具体链接如下：http://www.hightopo.com/demo/label/index.html