RU Элементы управления SVG
Вики ▸ Справка по API ▸ SVG ▸ Элементы управления SVG
English | Русский
# d3.svg.brush()
Конструирует новую кисть с масштабами по умолчанию по осям x и y и пустыми размерами.
# brush(selection)
Рисует или перерисовывает данную кисть внутри указанных элементов selection. Кисть может рисоваться одновременно внутри нескольких элементов, но обратите внимание, что эти кисти имеют один и тот же размер подложки; обычно же кисть рисуетс только на одном элементе за раз. Параметр selection также может быть переходом, в этом случае кисть будет выполнять автоматический переход. Используйте brush.event для перехвата событий кисти во время перехода анимированных кистей.
# brush.x([scale])
Возвращает / устанавливает масштаб по оси x, ассоциированный с кистью. Если указан параметр scale, устанавливает масштаб по оси x и возвращает кисть; если параметр scale не указан, возвращает текущий масштаб по оси x, который по умолчанию равен null. Шкала обычно определяется как количественная шкала, в этом случае размеры определяются по пространству данных из домена шкалы; однако, она может быть определена как порядковая шкала, и тогда размеры определяются в пространстве пикселей из диапазона шкалы.
# brush.y([scale])
Возвращает / устанавливает масштаб по оси y, ассоциированный с кистью. Если указан параметр scale, устанавливает масштаб по оси y и возвращает кисть; если параметр scale не указан, возвращает текущий масштаб по оси y, который по умолчанию равен null. Шкала обычно определяется как количественная шкала, в этом случае размеры определяются по пространству данных из домена шкалы; однако, она может быть определена как порядковая шкала, и тогда размеры определяются в пространстве пикселей из диапазона шкалы.
# brush.extent([values])
Возвращает / устанавливает размеры кисти. Если указан параметр values, устанавливает размеры в указанные значения и возвращает кисть; если параметр values не указан, возвращает текущие размеры. Определение размера зависит от ассоциированных с кистью шкал. Если доступны шкалы и по оси x, и по оси y, размер является двумерным массивом [[x0, y0], [x1, y1]], где x0 и y0 определяют нижние границы размера, а x1 и y1 — верхние. Если доступна только шкала по оси x, то размер определяется как одномерный массив [x0, x1]; аналогично, если доступна только шкала y, то размер будет [y0, y1]. Если не определена ни одна шкала, размером будет null.
Когда размер устанавливается в значения values, результирующий размер сохраняется с точно этими же значениями. Однако, как только кисть будет перемещена пользователем (событие mousemove, следующее за событием mousedown), размер должен быть пересчитан путём вызова метода scale.invert. Обратите внимание, что значения могут буть неточными из-за ограниченной точности пискелей.
Обратите внимание, что вызов метода не делает автоматической перерисовки или перенаправления любых событий в слушатели. Для перерисовки кисти вызовите метод brush на выборке изи переходе; для перенаправления соыбтий используйте метод brush.event.
# brush.clamp([clamp])
Возвращает / устанавливает поведение отсечения. Если указан параметр clamp, устанавливает поведение отсечения и возвращает кисть; если параметр clamp не указан, возвращает текущее поведение отсечения. Определение поведения отсечения зависит от ассоциированных с кистью шкал. Если доступны шкалы и по оси x, и по оси y, поведение отсечения является массивом [ x, y ], где x и y являются булевыми значениями, определяющими, какие из измерений двумерного размера должны быть отсечены по соответствующим шкалам. Если доступна только одна из шкал, то поведение отсечения является булевым значением, определяющим, должен ли отсекаться одномерный размер по данной шкале. Если не определена ни одна шкала, поведение отсечения будет null.
# brush.clear()
Очищает размеры, делая размеры кисти пустыми.
# brush.empty()
Возвращает true тогда и только тогда, когда размеры кисти пустые. При создании кисти они изначально пустые; так же кисть может стать пустой при одиночном щелчке по фону без перемещения или если размеры будут очищены. Кисть считается пустой, когда у неё нулевая ширина или высота. Когда кисть является пустой, её размеры строго не определены.
# brush.on(type[, listener])
Возвращает / устанавливает слушатель событий listener для указанного типа события type. Кисти поддерживают три типа событий:
- brushstart — возникает по событию mousedown, т.е. при нажатии кнопки мыши
- brush — возникает по событию mousemove, т.е. при перемещении мыши, если размеры кисти изменились
- brushend — возникает по событию mouseup, т.е. при отпускании кнопки мыши
Обратите внимание, что при щелчке по фону событие mousedown также запускает событие brush, поскольку размеры кисти немедленно очищаются для создания нового размера.
# brush.event(selection)
Если параметр selection является выборкой, немедленно перенаправляет жест кистью в зарегистрированные слушатели событий в качестве последовательности трёх событий — brushstart, brush и brushend. Это может быть полезно для срабатывания слушателей после программной установки размера кисти. Если параметр selection является переходом, регистрирует соответствующую функцию перехода, так что кисть перенаправляет события в процессе перехода; событие brushstart возникает при начале перехода из предыдущего установленного размера, события brush возникают с каждым тиком перехода и, наконец, событие brushend возникает при окончании перехода. Обратите внимание, что переход будет прерван, если пользователь начнёт рисовать до окончания перехода.