網路拓撲圖上文字的巧妙應用

圖撲軟體發表於2016-09-26

在前端網頁設計中，文字是重要的組成部分，那麼在網路拓撲圖中也是一樣的，文字在網路拓撲圖上最基本的顯示功能之一，在不同的應用場景下，會有不同的需求。但是不同的需求也逃不過一些基礎設定，如位置、旋轉、字型、顏色等需求。接下來我們就來詳細聊聊 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

相關文章