假设这样一个场景,用户在Cesium球上加载了一个GeoJson文件(DataSource),里面是全美国所有州的Geometry信息(Entity),叠加到球面后,你自然会有一种冲动,点击某一个州,了解这个州的基本信息。场景如下图所示:
这个点击行为,对应的是选择控件(SelectionIndicator),而呈现信息的载体,就是信息框控件(InfoBox)。
如上是一个简单的逻辑关系,可见Viewer.SelectEntity属性起到了承上启下的作用。首先,Viewer模块负责UI的事件交互,比如鼠标点击或者双击,则会触发对应事件,判断当前的鼠标事件是否选中了Entity,如果选中,则更新Viewer.SelectEntity属性。
如上,可以看到在Cesium源码中,目前绑定了两个事件,一个是鼠标左键单击,选中该Entity,一个是鼠标左键双击,则会追踪到该位置。当然,如果你想要增加或者修改某个事件,则可以修改screenSpaceEventHandler的内容。可以参考 screenSpaceEventHandler,比如很多人希望取消双击效果,则可以调用:viewer.cesiumWidget.screenSpaceEventHandler.removeInputAction(Cesium.ScreenSpaceEventType.LEFT_DOUBLE_CLICK);
而无论是单击还是双击,内部都是通过pickEntity获取选中的Entity,该方法内部通过ID作为唯一标识,判断是否选中某一Entity,具体实现我们以后在详细讨论。而在单击中,会调用Viewer.SelectEntity的Set方法,此时,当状态发生变化时(选中或消失),都会触发选择控件的动画效果:
如上就是一个Entity从鼠标选中,事件的触发以及属性信息的显示的大致过程。
但Cesiu支持实时性的InfoBox状态更新,也就是说,在每一帧,我们都可以更新选择控件和信息框控件的状态,而这,就要从Viewer.prototype._onTick说起。
首先,Viewer.prototype._onTick由Clock.onTick事件触发,而时钟本身在每一帧都会触发onTick事件,因此Viewer也可以通过onTick来实现自身的更新。
机智的你一眼就看到了time参数,原来如此。这时,根据time时间,我们获取对应的description,字符串类型,本身就是一个div,然后赋给infoBoxViewModel.description进而实现InfoBox控件的实时更新。
通常,每一个Entity的description都是固定内容,不需要根据时间等变换,而如果对实时性有一定要求,或者需要自定义效果,则需要匿名函数来实现回调方法。在这看不见的地方,主要是createPropertyDescriptor,Property两者间错综复杂的关系…
如上是Entity中description的属性定义,通过createPropertyDescriptor把Entity. description封装成Property,提供了Set和Get方法,方便该属性的调用。这里createPropertyDescriptor会根据属性赋值来选择具体的Property子类来满足不同需求,稍后在介绍完Property在详细解释这一部分。
对于Property,则会调用getValueOrDefault方法,获取该Entity的description,获取每一个Entity对应的描述信息,这里,每一个Property都需要提供一个getValue的标准方法,这也是每一个Property子类必须要实现的方法:
而Property有很多子类,但在InfoBox中,主要涉及到CallbackProperty和ConstantProperty两种类型,通过命名我们不难看出,前者是一种回调方式,而后者则是一个常量。
好了,对Property有了一个基本认识后,我们在看看createPropertyDescriptor的具体实现:
高亮处代码,不难看出,在创建时优先考虑CallbackProperty的属性,如果用户没有采用这种属性,此时,value为String类型而不是Property,所以没有实现value. getValue方法,则将value(String)封装为ConstantProperty。所以,constant常量的方式非常简单,直接赋值即可:
Entity.description = “<div> description</div>”;
可我偏要用回调的方式,如何破?我们看看GeoJsonDataSource中是如何实现的。
首先,你要实现一个匿名函数,如上,实现一个describe方法,其中,因为是匿名函数,所以可以随时获取到该Entity的所有属性的Key-Value,可以根据自己的需要来创建对应的DIV,另外,该匿名函数也提供time参数,满足对实时性的需求。
如果,万事俱备,我们就可以开心的创建一个CallbackProperty了:
而CallbackProperty的getValue的实现如下,通过该方法,可以把Entity的description属性,通过CallbackProperty,以RunTime的方式传递给InfoBox,如此,通过CallbackProperty可以实现动态显示InfoBox信息的方式:
基本上,InfoBox的实现大致如此,可以看到,Cesium的InfoBox的还是很成熟的,尽可以的在无编码的情况下显示Entity的属性,同时,也能满足自定义的扩展,并能够满足实时性的要求,而且封装的很优雅,也很简单,真的不是随便就能写来的……
光说不练假把式,写了这么多,相见ifoBox.html,,基于本文涉及到的知识点,实现了自定义InfoBox内容,并可以通过chart实现动态效果。具体代码参考infobox.html范例