基於HTML5 Canvas 實現彈出框

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

　　這個場景圖是基於 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）簡單繪制了下，也還蠻好用。在上述場景中，用戶將鼠標移入到草地等對象時，會有彈出框顯示它的詳細信息。

具體實現如下：

准備工作

 　　引入我們的 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');
    });

    //新建node
    var 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數據綁定手冊（http://www.hightopo.com/guide/guide/core/datamodel/ht-datamodel-guide.html）。例如，在這里，'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 （http://www.hightopo.com/demo/blog_meadow_20170605/index.html），供大家參考。