{ "id": { "desc": "
组件 ID。默认不指定。指定则可用于在 option 或者 API 中引用组件。
\n" }, "disabled": { "desc": "\n\n是否停止组件的功能。
\n", "uiControl": { "type": "boolean" } }, "xAxisIndex": { "desc": "设置 dataZoom-inside 组件控制的 x轴(即xAxis,是直角坐标系中的概念,参见 grid)。
不指定时,当 dataZoom-inside.orient 为 'horizontal'时,默认控制和 dataZoom 平行的第一个 xAxis。但是不建议使用默认值,建议显式指定。
如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。
例如有如下 ECharts option:
\noption: {\n xAxis: [\n {...}, // 第一个 xAxis\n {...}, // 第二个 xAxis\n {...}, // 第三个 xAxis\n {...} // 第四个 xAxis\n ],\n dataZoom: [\n { // 第一个 dataZoom 组件\n xAxisIndex: [0, 2] // 表示这个 dataZoom 组件控制 第一个 和 第三个 xAxis\n },\n { // 第二个 dataZoom 组件\n xAxisIndex: 3 // 表示这个 dataZoom 组件控制 第四个 xAxis\n }\n ]\n}\n\n"
},
"yAxisIndex": {
"desc": "设置 dataZoom-inside 组件控制的 y轴(即yAxis,是直角坐标系中的概念,参见 grid)。
不指定时,当 dataZoom-inside.orient 为 'vertical'时,默认控制和 dataZoom 平行的第一个 yAxis。但是不建议使用默认值,建议显式指定。
如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。
例如有如下 ECharts option:
\noption: {\n yAxis: [\n {...}, // 第一个 yAxis\n {...}, // 第二个 yAxis\n {...}, // 第三个 yAxis\n {...} // 第四个 yAxis\n ],\n dataZoom: [\n { // 第一个 dataZoom 组件\n yAxisIndex: [0, 2] // 表示这个 dataZoom 组件控制 第一个 和 第三个 yAxis\n },\n { // 第二个 dataZoom 组件\n yAxisIndex: 3 // 表示这个 dataZoom 组件控制 第四个 yAxis\n }\n ]\n}\n\n"
},
"radiusAxisIndex": {
"desc": "设置 dataZoom-inside 组件控制的 radius 轴(即radiusAxis,是直角坐标系中的概念,参见 polar)。
如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。
例如有如下 ECharts option:
\noption: {\n radiusAxis: [\n {...}, // 第一个 radiusAxis\n {...}, // 第二个 radiusAxis\n {...}, // 第三个 radiusAxis\n {...} // 第四个 radiusAxis\n ],\n dataZoom: [\n { // 第一个 dataZoom 组件\n radiusAxisIndex: [0, 2] // 表示这个 dataZoom 组件控制 第一个 和 第三个 radiusAxis\n },\n { // 第二个 dataZoom 组件\n radiusAxisIndex: 3 // 表示这个 dataZoom 组件控制 第四个 radiusAxis\n }\n ]\n}\n\n"
},
"angleAxisIndex": {
"desc": "设置 dataZoom-inside 组件控制的 angle 轴(即angleAxis,是直角坐标系中的概念,参见 polar)。
如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。
例如有如下 ECharts option:
\noption: {\n angleAxis: [\n {...}, // 第一个 angleAxis\n {...}, // 第二个 angleAxis\n {...}, // 第三个 angleAxis\n {...} // 第四个 angleAxis\n ],\n dataZoom: [\n { // 第一个 dataZoom 组件\n angleAxisIndex: [0, 2] // 表示这个 dataZoom 组件控制 第一个 和 第三个 angleAxis\n },\n { // 第二个 dataZoom 组件\n angleAxisIndex: 3 // 表示这个 dataZoom 组件控制 第四个 angleAxis\n }\n ]\n}\n\n"
},
"filterMode": {
"desc": "\n\n\n\ndataZoom 的运行原理是通过 数据过滤 以及在内部设置轴的显示窗口来达到 数据窗口缩放 的效果。
数据过滤模式(dataZoom.filterMode)的设置不同,效果也不同。
\n可选值为:
\n'filter':当前数据窗口外的数据,被 过滤掉。即 会 影响其他轴的数据范围。每个数据项,只要有一个维度在数据窗口外,整个数据项就会被过滤掉。
\n'weakFilter':当前数据窗口外的数据,被 过滤掉。即 会 影响其他轴的数据范围。每个数据项,只有当全部维度都在数据窗口同侧外部,整个数据项才会被过滤掉。
\n'empty':当前数据窗口外的数据,被 设置为空。即 不会 影响其他轴的数据范围。
\n'none': 不过滤数据,只改变数轴范围。
\n如何设置,由用户根据场景和需求自己决定。经验来说:
\n当『只有 X 轴 或 只有 Y 轴受 dataZoom 组件控制』时,常使用 filterMode: 'filter',这样能使另一个轴自适应过滤后的数值范围。
当『X 轴 Y 轴分别受 dataZoom 组件控制』时:
如果 X 轴和 Y 轴是『同等地位的、不应互相影响的』,比如在『双数值轴散点图』中,那么两个轴可都设为 fiterMode: 'empty'。
如果 X 轴为主,Y 轴为辅,比如在『柱状图』中,需要『拖动 dataZoomX 改变 X 轴过滤柱子时,Y 轴的范围也自适应剩余柱子的高度』,『拖动 dataZoomY 改变 Y 轴过滤柱子时,X 轴范围不受影响』,那么就 X轴设为 fiterMode: 'filter',Y 轴设为 fiterMode: 'empty',即主轴 'filter',辅轴 'empty'。
下面是个具体例子:
\noption = {\n dataZoom: [\n {\n id: 'dataZoomX',\n type: 'slider',\n xAxisIndex: [0],\n filterMode: 'filter'\n },\n {\n id: 'dataZoomY',\n type: 'slider',\n yAxisIndex: [0],\n filterMode: 'empty'\n }\n ],\n xAxis: {type: 'value'},\n yAxis: {type: 'value'},\n series{\n type: 'bar',\n data: [\n // 第一列对应 X 轴,第二列对应 Y 轴。\n [12, 24, 36],\n [90, 80, 70],\n [3, 9, 27],\n [1, 11, 111]\n ]\n }\n}\n\n上例中,dataZoomX 的 filterMode 设置为 'filter'。于是,假设当用户拖拽 dataZoomX(不去动 dataZoomY)导致其 valueWindow 变为 [2, 50] 时,dataZoomX 对 series.data 的第一列进行遍历,窗口外的整项去掉,最终得到的 series.data 为:
[\n // 第一列对应 X 轴,第二列对应 Y 轴。\n [12, 24, 36],\n // [90, 80, 70] 整项被过滤掉,因为 90 在 dataWindow 之外。\n [3, 9, 27]\n // [1, 11, 111] 整项被过滤掉,因为 1 在 dataWindow 之外。\n]\n\n过滤前,series.data 中对应 Y 轴的值有 24、80、9、11,过滤后,只剩下 24 和 9,那么 Y 轴的显示范围就会自动改变以适应剩下的这两个值的显示(如果 Y 轴没有被设置 min、max 固定其显示范围的话)。
所以,filterMode: 'filter' 的效果是:过滤数据后使另外的轴也能自动适应当前数据的范围。
再从头来,上例中 dataZoomY 的 filterMode 设置为 'empty'。于是,假设当用户拖拽 dataZoomY(不去动 dataZoomX)导致其 dataWindow 变为 [10, 60] 时,dataZoomY 对 series.data 的第二列进行遍历,窗口外的值被设置为 empty (即替换为 NaN,这样设置为空的项,其所对应柱形,在 X 轴还有占位,只是不显示出来)。最终得到的 series.data 为:
[\n // 第一列对应 X 轴,第二列对应 Y 轴。\n [12, 24, 36],\n [90, NaN, 70], // 设置为 empty (NaN)\n [3, NaN, 27], // 设置为 empty (NaN)\n [1, 11, 111]\n]\n\n这时,series.data 中对应于 X 轴的值仍然全部保留不受影响,为 12、90、3、1。那么用户对 dataZoomY 的拖拽操作不会影响到 X 轴的范围。这样的效果,对于离群点(outlier)过滤功能,比较清晰。
如下面的例子:
\n