基于HTML5 Canvas实现用户交互 HTML5HT for Web拓扑图Canvas交互
很多人都有这样的疑问,基于HTML5 Canvas实现的元素怎么和用户进行交互?在这里我们用到HT for Web(http://www.hightopo.com/guide/guide/core/beginners/ht-beginners-guide.html)写了个Demo进行示例。
场景如下所示,在该场景中双击温度和湿度下的Node,会生成输入框供用户填写内容,这之后,用户按下“Enter”键可以将输入内容传到Node中,同时删除输入框,地址::http://www.hightopo.com/demo/GraphInput/display.html
接下来我们探讨一下具体实现:
准备工作如下:
<script src='ht.js'></script>
dataModel = new ht.DataModel(); graphView = new ht.graph.GraphView(dataModel); graphView.addToDOM();
1、利用系统中定义好的矢量资源进行反序列化来实现场景图:
ht.Default.xhrLoad('TemperatureIndex.json', function(text) { var json = ht.Default.parse(text); if(json.title) document.title = json.title; dataModel.deserialize(json); }
2、双击事件
本例双击会产生输入框,在我们的HT中,GraphView默认内置了一些交互器,以实现基本的选择、单双击、缩放、平移和编辑等交互的功能,内置的交互器有:
内置的Interactor在交互过程中会派发事件,可通过GraphView#addInteractorListener进行监听,简写为mi(详情可看HT for Web 入门手册http://www.hightopo.com/guide/guide/core/beginners/ht-beginners-guide.html#ref_graphviewinteraction),在这里,我们用内置的graphView.addInteractorListener监听双击事件:
graphView.addInteractorListener(function(e){ if (e.kind !== 'doubleClickData') return; if (currentInput) removeInput(); var data = e.data; if (clickableTags[data.getTag()]){ setTimeout(function(){ createInput('input', data); }, 0); } });
3、创建输入框
在双击事件发生时,首先需要判断发生双击事件的元素是不是场景中定义的标签名‘temperature’和‘humidity’的node图元,我们用clickableTags对象来保存两个node:
var clickableTags = { 'temperature': true, 'humidity': true }
在双击的图元是‘temperature’或者‘humidity’时,调用createInput()函数生成输入框,createInput()代码如下:
function createInput(tagName,node){ if (currentInput) { removeInput(graphView, currentInput); return; } else { var element = document.createElement(tagName); graphView.getView().appendChild(element); element.bindingNode = node; ht.Default.setFocus(element); currentInput = element; layout(currentInput);//布局 return currentInput; } }
在createInput()函数中,用全局变量currentInput保存着当前生成的输入框元素,为保证再次生成输入框时,调用removeInput()清除上次生成的输入框元素,从而不影响性能。
4、布局
生成的输入框应该放在哪儿?这就是layout()函数中所做的事情。layout()函数修改生成的输入框的位置信息,让其在GraphView拓扑图组件上的位置刚好的node图元的位置相同。
function layout(element){ var rect = element.bindingNode.getRect(); var x = rect.x; var y = rect.y; element.style.position = 'absolute'; element.style.width = rect.width + 'px'; element.style.height = rect.height + 'px'; element.style.top = y + 'px'; element.style.left = x + 'px'; element.style.background = '#fff'; element.style.color = '#000'; element.style.textAlign = 'center'; }
以‘temperature’为例,在点击标签名为‘temperature’的node图元时,会在其上生成一个输入框,获取该node图元的宽、高、位置信息,并分别赋值给绝对定位后输入框的宽、高、位置,这样即可让输入框刚好覆盖住node图元。
5、平移和缩放
可能细心思考的朋友也会发现,在对整个场景图进行平移和缩放时,按照上诉布局方式,输入框的位置和大小却没有跟随着node图元的位置进行改变,所以我们在布局时还需要思考到平移、缩放事件。
首先,layout函数的内容中,元素的宽、高、位置信息必须加入平移和缩放产生的结果,所以,最终layout代码如下:
function layout(element){ var rect = element.bindingNode.getRect(); var zoom = graphView.getZoom(); var tx = graphView.tx(); var ty = graphView.ty(); rect.x *= zoom; rect.y *= zoom; rect.width *= zoom; rect.height *= zoom; var x = tx + rect.x; var y = ty + rect.y; element.style.position = 'absolute'; element.style.width = rect.width + 'px'; element.style.height = rect.height + 'px'; element.style.top = y + 'px'; element.style.left = x + 'px'; element.style.background = '#fff'; element.style.color = '#000'; element.style.textAlign = 'center'; }
其次,我们需要对平移和缩放事件添加监听,以便能在该事件发生时,再次调用layout()函数将输入框的位置进行同步,在这里,我们用内置的交互器addPropertyChangeListener(简写为mp),监听zoom、translateX、translateY属性的变化:
var changeProperties = { 'zoom': true, 'translateX': true, 'translateY':true }
graphView.mp(function(e) { if (changeProperties[e.property]) { var elements = document.getElementsByTagName('input'); for (var i = 0; i < elements.length; i++) { layout(elements[i]); } } });
6、更新node
大家在Demo中可以发现,我们按下Enter键时,输入的文字会同步到node中,其实这里做了两件事: 给node设值后删除输入框。
a、给node设值,是用一个名为setText()的函数来实现的,实现代码如下:
function setText(tagName){ var element = document.getElementsByTagName(tagName); if(!element) return; for (var i = 0; i < element.length; i++) { var value = (element[i].value) ? element[i].value : 32 ; element[i].bindingNode.s('text', value); } }
在检测输入框中值得存在性后,给node图元赋值用到我们HT的setStyle(简写为s)方法。
b、删除输入框
function removeInput(){ if(!currentInput) return; graphView.getView().removeChild(currentInput); currentInput = null; }
c、添加Enter的事件监听器
因为没有监听键盘的内置交互器,所以我们通过graphView.getView().addEventListener直接对底层的div添加监听。
graphView.getView().addEventListener('keydown', function(event){ if(ht.Default.isEnter(event)){ setText('input'); removeInput(); } else if(ht.Default.isEsc(event)){ removeInput(); } }, false);
最后,再贴上Demo地址(http://www.hightopo.com/demo/GraphInput/display.html),希望能够帮助那些需要在拓扑图中加入原生HTML的朋友,也望大家不吝赐教。