> [Wiki](Home) ▸ [[API--中文手册]] ▸ [[SVG函数]] ▸ **SVG 控件**
* 本文档是D3官方文档中文翻译，并保持与[最新版](https://github.com/mbostock/d3/wiki/API-Reference)同步。
* 如发现翻译不当或有其他问题可以通过以下方式联系译者:
* 邮箱：zhang_tianxu@sina.com
* QQ群：[D3数据可视化](http://jq.qq.com/?_wv=1027&k=ZGcqYF)205076374，[大数据可视化](http://jq.qq.com/?_wv=1027&k=S8wGMe)436442115
# d3.svg.brush()
构造一个新的刷子，使用默认的x和y比例尺，和空的范围extent。
# brush(selection)
绘制或重绘当前brush拖选到指定的选择元素；brush可以同时绘制多个元素，值得注意的是，这些选择刷会共用相同的背景范围；通常一个选择刷一个时间只能绘制一个元素；selection 参数可以是一个变换，在这种情况下，选择刷将自动执行变换；可以使用 brush.event 来触发选择刷事件在动画刷的变换过程中。
# brush.x([scale])
获取或设置选择刷相关联的x比例尺；如果指定scale ，则设置x比例尺为指定的scale 并返回brush，如果未指定scale ，则返回当前的x比例尺，默认为null；变换通常可指定为定量比例尺，在这种情况下，范围extent处于比例尺域 domain的数据空间；然而，它也可以被定义为定量比例尺代替，这时，范围extent来自于比例尺的的range extent的像素空间。
# brush.y([scale])
获取或设置选择刷相关联的y比例尺；如果指定scale ，则设置y比例尺为指定的scale 并返回brush，如果未指定scale ，则返回当前的y比例尺，默认为null；比例尺通常可指定为定量比例尺，在这种情况下，extent是来自于比例尺域 domain的数据空间；然而，它也可以被定义为序数比例尺ordinal scale代替，这时，范围extent来自于变换的range extent的像素区间。
# brush.extent([values])
获取或设置当前选择刷的范围，如果指定values，则设置范围为指定的值并返回当前brush；如果未指定values，则返回当前的范围；范围的定义依赖于关联的比例尺；如果x和y比例尺都可用，范围是一个二维的数组：[[x0, y0], [x1, y1]]，x0和y0是范围的最低端，x1和y1是范围的最顶端；如果只有x比例尺可用，范围被定义为一维数组：[x0, x1]，同样地，如果只有y变换可用，范围被定义为：[y0, y1]；如果没有变换可用，范围为null。
当范围被设定为指定的值values，所得到的范围会被正确的保存起来；然而，一旦选择刷被用户移动（鼠标按下并被拖动），这时，范围必须要调用 scale.invert来重新计算；注意，在这种情况下，值可能由于像素的精度有限而略有偏差。
注意，这并不会自动重绘选择刷或触发任何的监听事件；想要重绘选择刷，可以在选择器或过渡上调用 brush ，想要触发事件，使用 brush.event。
# brush.clamp([clamp])
设置或获取当前的夹选行为，如果指定clamp，则设置夹选行为为指定值并返回brush，如果未指定clamp，则返回当前的行为；夹选行为的定义依赖于关联的比例尺；如果x和y比例尺都可用，夹选行为是一个数组[x,y]，x和y是布尔类型，用来确定是否二维范围内每个维度应该被夹选到各自的x和y比例尺；如果只有x或y比例尺可用，夹选行为是一个布尔类型，用来指定是否一维范围该被夹选到比例尺，如果变换都不可用，则夹选行为是null。
# brush.clear()
Clears the extent, making the brush extent empty.
清空范围，使得brush的范围为 empty。
# brush.empty()
当且仅当选择刷的范围为空时，返回true；当brush被创建时，被初始化为空；当点击背景而不移动时，或者范围为空时，选择刷会变为空的；如果选择刷有零宽度或零高度，它将被视为空；当选择刷为空，则它的范围即视为未定义。
# brush.on(type[, listener])
设置或获取指定类型type的监听器listener ；选择刷支持三种类型事件：
• Brushstart - 鼠标按下时，即mousedown；
• brush - 鼠标移动时，如果范围在改变，即mousemove；
• brushend – 鼠标弹起/松开时，即mouseup；
需要注意，当鼠标在背景上点击时也会触发brush事件，因为选择刷范围会立刻被清除来开始一段新的范围。
# brush.event(selection)
如果selection是选择器，立刻触发brush行为到注册的监听器，即三个事件序列： brushstart, brush 和 brushend；这是非常有用的，在设置完 brush extent后来触发相应的事件；如果selection 是一个过渡，注册合适的补间动画，这样在过渡的过程中来触发事件：当过渡开始于初始设置范围时触发brushstart ，过渡进行期间每刻都会触发brush ，过渡结束时触发brushend ；需要注意，当用户开始刷时，即使过渡没结束也会被立刻终止interrupted。
* 魏飞译 2014-07-25 19:25 咕噜校对 2014-11-29 20:06:46
