
前言
用戶鼠標移入時,有彈出框出現,這樣的需求很常見。這在處理 HTML 元素實現時簡單,但是如果是對 HTML5 Canvas 構成的圖形進行處理,這種方法不再適用,因為 Canvas 使用的是另外一套機制,無論在 Canvas 上繪制多少圖形,Canvas 都是一個整體。而圖形本身實際都是 Canvas 的一部分,不可單獨獲取,所以也就無法直接給某個圖形增加 JavaScript 事件。然而,在HT for Web 中,這種需求很容易實現,場景如下:

這個場景圖是基于 HT for Web 的 JSON 文件,可能大家對怎么生成這樣的 JSON 文件有疑惑,其實這里是基于這個麻雀雖小五臟俱全的 “HTML5拓撲圖編輯器” (http://www.hightopo.com/demo/2deditor_20151010/HT-2D-Editor.html )進行了擴展,很容易就自定義出滿足我需求拓撲編輯器。不僅如此,在這個 Demo 中,定義的三種類型彈框的矢量圖 ‘tips1.json’、‘tips2.json’、‘tips3.json’ 是通過這個矢量編輯器(http://www.hightopo.com/demo/vector-editor/index.html )簡單繪制了下,也還蠻好用。在上述場景中,用戶將鼠標移入到草地等對象時,會有彈出框顯示它的詳細信息,Demo地址:http://www.hightopo.com/demo/blog_meadow_20170605/index.html
具體實現
準備工作
引入我們的HT(http://www.hightopo.com/ ):
<script src='ht.js'></script>
dataModel = new ht.DataModel();
graphView = new ht.graph.GraphView(dataModel);
graphView.addToDOM();
HT 提供了自定義的 JSON 格式的矢量描述形式,以HT標準定義的 JSON 矢量格式,也可以作為圖片進行注冊和使用,HT 的矢量方式比傳統格式更節省空間,縮放不失真,戳 HT for Web 了解詳細信息。這里將三種形狀的 JSON 彈出框注冊成圖片以便后續調用:
ht.Default.setImage('tips1', 'symbols/tips1.json');
ht.Default.setImage('tips2', 'symbols/tips2.json');
ht.Default.setImage('tips3', 'symbols/tips3.json');
然后獲取有交互效果的對象,其中各個對象中的屬性名是給各個圖元設置好的標簽名:
// 樹
var tree = {'tree1' : true,'tree2' : true,'tree3' : true
};// 草地
var grass = {'grass1' : true,'grass2' : true,'grass3' : true};// 山
var mountain = {'mountain': true
};
彈出框
其實彈出框的本質是一個 Node,當用戶鼠標移入移出時,
1、控制Node的隱藏和顯示可以達到彈框的效果;
2、鼠標位置的改變伴隨著Node位置的改變;
3、鼠標移入到不同的對象上時,Node上的貼圖也跟著發生變化;
4、Node 中的屬性值也隨著鼠標位置發生變化。
所以,要實現彈框,首先應新建 Node,并將其的層級設置為 ‘higher’,在這之前還需要將場景圖的 JSON 文件反序列化,并且給反序列化后的圖元均設置為層級 ‘lower’ ,防止被已有的圖元擋住:
ht.Default.xhrLoad('meadow.json', function(text) {const json = ht.Default.parse(text); if(json.title) document.title = json.title;dataModel.deserialize(json);// 設置層級dataModel.each(function(data){data.setLayer('lower');});// 新建nodevar node = new ht.Node(); node.s('2d.visible',false);node.setLayer('higher');dataModel.add(node);})
然后,對底層的 DIV 監聽 mousemove 事件,判斷鼠標的位置是否在上述三個對象之上,根據對象類型,調用 layout() 函數對 Node 重新布局:
graphView.getView().addEventListener('mousemove', function(e) {node.s('2d.visible',false);var hoverData = graphView.getDataAt(e);pos = graphView.getLogicalPoint(e);if(!hoverData) return; if(tree[hoverData.getTag()]){ layout(node, pos, 'tips1');} else if (grass[hoverData.getTag()]) {layout(node, pos, 'tips2');} else if (mountain[hoverData.getTag()]) {layout(node, pos, 'tips3');}
});
layout() 函數所做的事情,已經在前面詳細的闡述,其中,彈框中屬性值的更新是將 JSON 文件的的 text 屬性進行數據綁定,綁定的格式很簡單,只需將以前的參數值用一個帶 func 屬性的對象替換即可,func 的內容有一下幾種類型:
1、function類型,直接調用該函數,并傳入相關Data和view對象,由函數返回值決定參數值,即func(data, view);調用。
2、string類型:
- style@*** 開頭,則返回 data.getStyle(***) 值,其中 *** 代表 style 的屬性名。
- attr@*** 開頭,則返回 data.getAttr(***) 值,其中 *** 代表 attr 的屬性名。
- field@*** 開頭,則返回 data.*** 值,其中 *** 代表 attr 的屬性名。
如果不匹配以上幾種情況,則直接將 string 類型作為 data 對象的函數名調用 data***(view),返回值作為參數值。
除了 func 屬性外,還可以設置 value 屬性作為默認值,如果對應的 func 取得的值為 undefined 或者 null 時,則會采用 value 屬性定義的默認值,詳情可見 HT for Web 數據綁定手冊(數據模型手冊 - HT for Web )。例如,在這里,'tips1.json' 文件中對陽光值進行數據綁定的結果如下:
"text": {"func": "attr@sunshine","value": "陽光值"
}
下面貼上 layout() 函數的源代碼:
function layout(node, pos, type){node.s('2d.visible',true);node.setImage(type); if(type == 'tips1'){node.setPosition(pos.x + node.getWidth()/2, pos.y - node.getHeight()/2);node.a({'sunshine' : '陽光值 : '+ (pos.x/1000).toFixed(2),'rain' : '雨露值 : '+ (pos.y/1000).toFixed(2),'love' : '愛心值 : ***'});} else if(type == 'tips2'){node.setPosition(pos.x , pos.y - node.getHeight()/2);node.a({'temp' : '溫度 : 30','humidity' : '濕度 : '+Math.round(pos.x/100)+'%'});} else if(type == 'tips3'){node.setPosition(pos.x - node.getWidth()/2, pos.y - node.getHeight()/2);node.a({'hight' : '海拔 : ' + Math.round(pos.y)+'米','landscapes' : '地貌 : 喀斯特'});}
}
云移動
最后,我們的 Demo 還有個云移動的動畫效果,在 HT 的數據模型驅動的圖形組件的設計架構下,動畫可理解為將某些屬性由起始值逐漸變為目標值的過程,HT 提供了 ht.Default.startAnim 的動畫函數,ht.Default.startAnim 支持 Frame-Based 和 Time-Based 兩種方式的動畫:
- Frame-Based 方式用戶通過指定 frames 動畫幀數,以及 interval 動畫幀間隔參數控制動畫效果;
- Time-Based 方式用戶只需要指定 duration 的動畫周期的毫秒數即可,HT 將在指定的時間周期內完成動畫。
詳情見 HT for Web。
在這里我們用的是 Time-Based 方式,源碼如下:
var cloud = dataModel.getDataByTag('cloud');
parent = dataModel.getDataByTag('mountain');
round1 = parent.getPosition().x - parent.getWidth()/2 + cloud.getWidth()/2;
round2 = parent.getPosition().x + parent.getWidth()/2 - cloud.getWidth()/2;
end = round1;// 云運動動畫
var animParam = {duration: 10000,finishFunc: function() { end = (end == round1) ? round2 : round1;ht.Default.startAnim(animParam);},action: function(v, t) {var p = cloud.getPosition();cloud.setPosition(p.x + (end - p.x) * v , p.y);}
};
ht.Default.startAnim(animParam);
總結
最后,再放上我們的 Demo 供大家參考。
