创新互联ECharts教程：ECharts区域选择组件（brush）的属性

brush.toolbox   |   Array

[ default: ['rect', 'polygon', 'keep', 'clear'] ]

使用在 toolbox 中的 brush 按钮。

brush 相关的 toolbox 按钮有：

  • 'rect'：开启矩形选框选择功能。
  • 'polygon'：开启任意形状选框选择功能。
  • 'lineX'：开启横向选择功能。
  • 'lineY'：开启纵向选择功能。
  • 'keep'：切换『单选』和『多选』模式。后者可支持同时画多个选框。前者支持单击清除所有选框。
  • 'clear'：清空所有选框。

brush.brushLink   |   Array, string

[ default: null ]

不同系列间，选中的项可以联动。

参见如下效果（刷选一个 scatter，其他 scatter 以及 parallel 图都会有选中效果）：

brushLink 配置项是一个数组，内容是 seriesIndex，指定了哪些 series 可以被联动。例如可以是：

  • [3, 4, 5] 表示 seriesIndex 为 3, 4, 5 的 series 可以被联动。
  • 'all' 表示所有 series 都进行 brushLink。
  • 'none' 或 null 或 undefined 表示不启用 brushLink 功能。

注意

brushLink 是通过 dataIndex 进行映射，所以需要保证，联动的每个系列的 data 都是 index 对应的。*

例如：

option = {
    brush: {
        brushLink: [0, 1]
    },
    series: [
        {
            type: 'bar'
            data: [232,    4434,    545,      654]     // data 有四个项
        },
        {
            type: 'parallel',
            data: [[4, 5], [3, 5], [66, 33], [99, 66]] // data 同样有四个项，两个系列的 data 是对应的。
        }
    ]
};

brush.seriesIndex   |   Array, number, string

[ default: 'all' ]

指定哪些 series 可以被刷选，可取值为：

  • 'all': 所有 series
  • 'Array': series index 列表
  • 'number': 某个 series index

brush.geoIndex   |   Array, number, string

[ default: null ]

指定哪些 geo 可以被刷选。

可以设置 brush 是『全局的』还是『属于坐标系的』。

全局 brush

在 echarts 实例中任意地方刷选。这是默认情况。如果没有指定为『坐标系 brush』，就是『全局 brush』。

坐标系 brush

在 指定的坐标系中刷选。选框可以跟随坐标系的缩放和平移（roam 和 dataZoom）而移动。

坐标系 brush 实际更为常用，尤其是在 geo 中。

通过指定 brush.geoIndex 或 brush.xAxisIndex 或 brush.yAxisIndex 来规定可以在哪些坐标系中进行刷选。

这几个配置项的取值可以是：

  • 'all'，表示所有
  • number，如 0，表示这个 index 所对应的坐标系。
  • Array，如 [0, 4, 2]，表示指定这些 index 所对应的坐标系。
  • 'none' 或 null 或 undefined，表示不指定。

例如：

option = {
    geo: {
        ...
    },
    brush: {
        geoIndex: 'all', // 只可以在所有 geo 坐标系中刷选，也就是上面定义的 geo 组件中。
        ...
    }
};

例如：

option = {
    grid: [
        {...}, // grid 0
        {...}  // grid 1
    ],
    xAxis: [
        {gridIndex: 1, ...}, // xAxis 0，属于 grid 1。
        {gridIndex: 0, ...}  // xAxis 1，属于 grid 0。
    ],
    yAxis: [
        {gridIndex: 1, ...}, // yAxis 0，属于 grid 1。
        {gridIndex: 0, ...}  // yAxis 1，属于 grid 0。
    ],
    brush: {
        xAxisIndex: [0, 1], // 只可以在 xAxisIndex 为 `0` 和 `1` 的 xAxis 所在的直角坐标系中刷选。
        ...
    }
};

brush.xAxisIndex   |   Array, number, string

[ default: null ]

指定哪些 xAxisIndex 可以被刷选。

可以设置 brush 是『全局的』还是『属于坐标系的』。

1、全局 brush

在 echarts 实例中任意地方刷选。这是默认情况。如果没有指定为『坐标系 brush』，就是『全局 brush』。

2、坐标系 brush

在 指定的坐标系中刷选。选框可以跟随坐标系的缩放和平移（roam 和 dataZoom）而移动。

坐标系 brush 实际更为常用，尤其是在 geo 中。

通过指定 brush.geoIndex 或 brush.xAxisIndex 或 brush.yAxisIndex 来规定可以在哪些坐标系中进行刷选。

这几个配置项的取值可以是：

  • 'all'，表示所有
  • number，如 0，表示这个 index 所对应的坐标系。
  • Array，如 [0, 4, 2]，表示指定这些 index 所对应的坐标系。
  • 'none' 或 null 或 undefined，表示不指定。

例如：

option = {
    geo: {
        ...
    },
    brush: {
        geoIndex: 'all', // 只可以在所有 geo 坐标系中刷选，也就是上面定义的 geo 组件中。
        ...
    }
};

例如：

option = {
    grid: [
        {...}, // grid 0
        {...}  // grid 1
    ],
    xAxis: [
        {gridIndex: 1, ...}, // xAxis 0，属于 grid 1。
        {gridIndex: 0, ...}  // xAxis 1，属于 grid 0。
    ],
    yAxis: [
        {gridIndex: 1, ...}, // yAxis 0，属于 grid 1。
        {gridIndex: 0, ...}  // yAxis 1，属于 grid 0。
    ],
    brush: {
        xAxisIndex: [0, 1], // 只可以在 xAxisIndex 为 `0` 和 `1` 的 xAxis 所在的直角坐标系中刷选。
        ...
    }
};

brush.yAxisIndex   |   Array, number, string

[ default: null ]

指定哪些 yAxisIndex 可以被刷选。

可以设置 brush 是『全局的』还是『属于坐标系的』。

1、全局 brush

在 echarts 实例中任意地方刷选。这是默认情况。如果没有指定为『坐标系 brush』，就是『全局 brush』。

2、坐标系 brush

在 指定的坐标系中刷选。选框可以跟随坐标系的缩放和平移（roam 和 dataZoom）而移动。

坐标系 brush 实际更为常用，尤其是在 geo 中。

通过指定 brush.geoIndex 或 brush.xAxisIndex 或 brush.yAxisIndex 来规定可以在哪些坐标系中进行刷选。

这几个配置项的取值可以是：

  • 'all'，表示所有
  • number，如 0，表示这个 index 所对应的坐标系。
  • Array，如 [0, 4, 2]，表示指定这些 index 所对应的坐标系。
  • 'none' 或 null 或 undefined，表示不指定。

例如：

option = {
    geo: {
        ...
    },
    brush: {
        geoIndex: 'all', // 只可以在所有 geo 坐标系中刷选，也就是上面定义的 geo 组件中。
        ...
    }
};

例如：

option = {
    grid: [
        {...}, // grid 0
        {...}  // grid 1
    ],
    xAxis: [
        {gridIndex: 1, ...}, // xAxis 0，属于 grid 1。
        {gridIndex: 0, ...}  // xAxis 1，属于 grid 0。
    ],
    yAxis: [
        {gridIndex: 1, ...}, // yAxis 0，属于 grid 1。
        {gridIndex: 0, ...}  // yAxis 1，属于 grid 0。
    ],
    brush: {
        xAxisIndex: [0, 1], // 只可以在 xAxisIndex 为 `0` 和 `1` 的 xAxis 所在的直角坐标系中刷选。
        ...
    }
};

brush.brushType   |   string

[ default: 'rect' ]

默认的刷子类型。

  • 'rect'：矩形选框。
  • 'polygon'：任意形状选框。
  • 'lineX'：横向选择。
  • 'lineY'：纵向选择。

brush.brushMode   |   string

[ default: 'single' ]

默认的刷子的模式。可取值为：

  • 'single'：单选。
  • 'multiple'：多选。

brush.transformable   |   boolean

[ default: true ]

已经选好的选框是否可以被调整形状或平移。

brush.brushStyle   |   Object

选框的默认样式，值为：

{
    borderWidth: 1,
    color: 'rgba(120,140,180,0.3)',
    borderColor: 'rgba(120,140,180,0.8)'
},

brush.throttleType   |   string

[ default: 'fixRate' ]

默认情况，刷选或者移动选区的时候，会不断得发 brushSelected 事件，从而告诉外界选中的内容。

但是频繁的事件可能导致性能问题，或者动画效果很差。所以 brush 组件提供了 brush.throttleType，brush.throttleDelay 来解决这个问题。

throttleType 取值可以是：

  • 'debounce'：表示只有停止动作了（即一段时间没有操作了），才会触发事件。时间阈值由 brush.throttleDelay 指定。
  • 'fixRate'：表示按照一定的频率触发时间，时间间隔由 brush.throttleDelay 指定。

例如这个 例子，就是使用了 debounce的效果：只有用户停止动作了，柱状图才更新。不然的话，如果柱状图的频繁更新，那么动画效果很差。

brush.throttleDelay   |   number

[ default: 0 ]

默认为 0 表示不开启 throttle。

默认情况，刷选或者移动选区的时候，会不断得发 brushSelected 事件，从而告诉外界选中的内容。

但是频繁的事件可能导致性能问题，或者动画效果很差。所以 brush 组件提供了 brush.throttleType，brush.throttleDelay 来解决这个问题。

throttleType 取值可以是：

  • 'debounce'：表示只有停止动作了（即一段时间没有操作了），才会触发事件。时间阈值由 brush.throttleDelay 指定。
  • 'fixRate'：表示按照一定的频率触发时间，时间间隔由 brush.throttleDelay 指定。

例如这个 例子，就是使用了 debounce的效果：只有用户停止动作了，柱状图才更新。不然的话，如果柱状图的频繁更新，那么动画效果很差。

brush.removeOnClick   |   number

[ default: true ]

在 brush.brushMode 为 'single' 的情况下，是否支持『单击清除所有选框』。

brush.inBrush   |   Object

定义在选中范围中的视觉元素。

可选的视觉元素有：

  • symbol: 图元的图形类别。
  • symbolSize: 图元的大小。
  • color: 图元的颜色。
  • colorAlpha: 图元的颜色的透明度。
  • opacity: 图元以及其附属物（如文字标签）的透明度。
  • colorLightness: 颜色的明暗度，参见 HSL。
  • colorSaturation: 颜色的饱和度，参见 HSL。
  • colorHue: 颜色的色调，参见 HSL。

大多数情况下，inBrush 可以不指定，维持本来的视觉配置。

brush.outOfBrush   |   Object

定义在选中范围外的视觉元素。

可选的视觉元素有：

  • symbol: 图元的图形类别。
  • symbolSize: 图元的大小。
  • color: 图元的颜色。
  • colorAlpha: 图元的颜色的透明度。
  • opacity: 图元以及其附属物（如文字标签）的透明度。
  • colorLightness: 颜色的明暗度，参见 HSL。
  • colorSaturation: 颜色的饱和度，参见 HSL。
  • colorHue: 颜色的色调，参见 HSL。

注意，如果 outOfBrush 没有指定，默认会设置 color: '#ddd'，如果你不想要这个 color，比如可以换成：

brush: {
    ...,
    outOfBrush: {
        colorAlpha: 0.1
    }
}

brush.z   |   number

[ default: 10000 ]

brush 选框的 z-index。当有和不想管组件有不正确的重叠时，可以进行调整。

网页标题：创新互联ECharts教程：ECharts区域选择组件（brush）的属性
文章出自：http://www.csdahua.cn/qtweb/news19/353969.html

网站建设、网络推广公司-快上网，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 快上网

成都快上网为您推荐相关内容

域名注册知识

同城分类信息

成都包装设计公司　　 　绵竹做网站　　 　成都艺考培训　　 　营销网站定位　　 　成都商城网站建设　　 　雅安服务器托管　　 　小谭建站　　 　天泽尚品装饰　　 　做网站设计　　 　四川胜锦安防　　 　雅安做网站　　 　成都营销网站建设　　 　微信开发　　 　网站建设策划方案　　 　泸县网站建设　　 　凯亚自动化控制　　 　自贡电信机房　　 　成都品牌网站设计　　 　恒翔机电　　 　防护网厂