touchTools
手势交互的工具,NiuChart将图表上的各种手势交互都封装成了手势交互工具类。touchTool 的种类有:"NXCursorTool"、"NXLineTool"、"NXPieSpinTool"、"NXChangeActiveSeriesTool"、"NXHighLightTool"、"NXZoomTool"、"NXNavigationTool"、"NXMapHighLightTool"。相关属性如下:
"targetSeries":需要设置此touchTool作用的series id。此属性为一个数组,可以将此touchTool作用于多个series。
"crossAxis":与此touchTool相交的axis id。
"toolType":表示此touchTool的种类。所有种类上文已说明。
"active":表示是否激活此touchTool。
touchTool针对自己的种类都有一套模板,使得不用重复配置相同属性节点。touchTool想要配置特殊的属性值,只需要覆盖模板的相应属性。模板见touchToolOptions
NXChartTool
所有touchTool的基类,相关属性如下:
"visible":表示手势交互是否出现,默认为出现,可以设置参数改变其交互。
"active":表示此touchTool是否处于激活状态,默认为激活状态。非激活状态的toolPlot灰色显示,激活状态则高亮显示。
"showBelowSeries":表示是否在series下面。多个图形绘制可能会有覆盖,设置此参数可以根据重要性toolPlot画在series下面或是上面。
NXMultiTouchChartTool
多指交互工具,支持单指和双指的手势交互,相关属性如下:
沿用父类NXChartTool的属性。
"enableMultiTouch":多指触摸是否可用。默认为可用。
"removeOnRelease":表示释放手指的时候,指示器toolPlot是否移除。
NXCursorTool
指示器为十字架的多指交互工具,用于泡泡图的手势交互中。单指时突显选中的数据点,双指时将两个数据点进行对比分析。相关属性如下:
沿用父类NXChartTool、NXMultiTouchChartTool、NXLineTool的属性。
NXLineTool
指示器为线性的多指交互工具。单指时突显选中的数据点,双指时将两个数据点进行对比分析。相关属性如下:
沿用父类NXChartTool和NXMultiTouchChartTool的属性。
"toolPlot":见toolPlot
NXPieSpinTool
用于饼图旋转的手势交互工具,相关属性如下:
沿用父类NXChartTool的属性。
"friction":摩擦系数,默认是0.95
"deceleration":加速度,默认是860°/s²
"maxInertiaShakeCount":模仿惯性最大的震荡次数,默认是5次
NXChangeActiveSeriesTool
改变series激活状态的手势交互工具。该工具可双击切换series,使当前激活的高亮显示,未激活的暗黑显示。相关属性如下:
沿用父类NXChartTool的属性。
NXHighLightTool
有坐标轴图表的高亮显示工具。该工具使选中的数据点高亮显示。相关属性如下:
沿用父类NXChartTool、NXMultiTouchChartTool、NXLineTool的属性。
NXZoomTool
用于地图缩放的手势交互工具,相关属性如下:
沿用父类NXChartTool的属性。
NXNavigationTool
作用在navigation上的手势交互工具。单击坐标轴,使得导航条与图表同步,并显示or消失,相关属性如下:
沿用父类NXChartTool的属性。
NXMapHighLightTool
用于地图高亮显示的交互工具,相关属性如下:
沿用父类NXChartTool、NXMultiTouchChartTool、NXLineTool的属性。
toolPlot
touchTool的可视化指示器。NiuChart将NXLineTool、NXCursorTool可视化,与手势同步移动,方便图表数据的分析。相关属性如下:
"singleTouchLineType":配置当单指触摸时,线性指示器的类型。可选项见NXLineToolType
"multiTouchLineType":配置当多指触摸时,线性指示器的类型。可选项见NXLineToolType
"lineStyle":指示器的线的样式,相关属性见lineStyle
"outerSymbol":线性指示器上标记物外圈的样式,相关属性见symbol
"innerSymbol":线性指示器上标记物内圈的样式,相关属性见symbol
NXLineToolType
线性指示器的类型。可选项有:NXLineToolTypeVertical垂直、NXLineToolTypeHorizontal水平、NXLineToolTypeCross十字架、NXLineToolTypeRect矩形