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