{ "id": { "desc": "

组件 ID。默认不指定。指定则可用于在 option 或者 API 中引用组件。

\n" }, "disabled": { "desc": "\n\n

是否停止组件的功能。

\n", "uiControl": { "type": "boolean" } }, "xAxisIndex": { "desc": "

设置 dataZoom-inside 组件控制的 x轴(即xAxis,是直角坐标系中的概念,参见 grid)。

\n

不指定时,当 dataZoom-inside.orient 为 'horizontal'时,默认控制和 dataZoom 平行的第一个 xAxis。但是不建议使用默认值,建议显式指定。

\n

如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。

\n

例如有如下 ECharts option:

\n
option: {\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)。

\n

不指定时,当 dataZoom-inside.orient 为 'vertical'时,默认控制和 dataZoom 平行的第一个 yAxis。但是不建议使用默认值,建议显式指定。

\n

如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。

\n

例如有如下 ECharts option:

\n
option: {\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)。

\n

如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。

\n

例如有如下 ECharts option:

\n
option: {\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)。

\n

如果是 number 表示控制一个轴,如果是 Array 表示控制多个轴。

\n

例如有如下 ECharts option:

\n
option: {\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\n

dataZoom 的运行原理是通过 数据过滤 以及在内部设置轴的显示窗口来达到 数据窗口缩放 的效果。

\n

数据过滤模式(dataZoom.filterMode)的设置不同,效果也不同。

\n

可选值为:

\n\n

如何设置,由用户根据场景和需求自己决定。经验来说:

\n\n

下面是个具体例子:

\n
option = {\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
[\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 固定其显示范围的话)。

\n

所以,filterMode: 'filter' 的效果是:过滤数据后使另外的轴也能自动适应当前数据的范围。

\n

再从头来,上例中 dataZoomY 的 filterMode 设置为 'empty'。于是,假设当用户拖拽 dataZoomY(不去动 dataZoomX)导致其 dataWindow 变为 [10, 60] 时,dataZoomY 对 series.data 的第二列进行遍历,窗口外的值被设置为 empty (即替换为 NaN,这样设置为空的项,其所对应柱形,在 X 轴还有占位,只是不显示出来)。最终得到的 series.data 为:

\n
[\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

如下面的例子:

\n