Draggable

public interface Draggable extends Hoverable

New in version 1.2.0.

Интерфейс, реализующий симуляцию действий пользователя для операций drag and drop.

Предоставляет методы для обработки нажатия, отпускания кнопки мыши и перетаскивания элементов.

Поддерживается функционал, реализованный в Hoverable.

See also

Fields

ACTIVE_ELEMENT

static final AtomicReference<WebElement> ACTIVE_ELEMENT

Элемент, на котором осуществляется операция drag and drop.

Methods

getDraggableWebElement

WebElement getDraggableWebElement()

Получить веб-элемент, используемый для операций drag and drop.

Returns:

Веб-элемент, который будет перетаскиваться

mouseDown

void mouseDown()

Нажимает и удерживает левую кнопку мыши на центре видимой части веб-элемента.

Перед нажатием выполняется наведение на элемент с помощью метода Hoverable.mouseOver(int, int).

mouseDown

void mouseDown(int xOffset, int yOffset)

Нажимает и удерживает левую кнопку мыши на элементе с указанным смещением относительно центра.

Начинает операцию перетаскивания.

Требует последующего вызова mouseUp() для завершения.

Перед нажатием выполняется наведение на элемент с помощью метода Hoverable.mouseOver(int, int).

Parameters:
  • xOffset – Смещение по оси X (в пикселях) от центра видимой части веб-элемента: положительное — вправо, отрицательное — влево.

  • yOffset – Смещение по оси Y (в пикселях) от центра видимой части веб-элемента: положительное — вниз, отрицательное — вверх.

Throws:
  • DraggableException – если левая кнопка мыши уже удерживается на другом элементе

mouseMoveByOffset

void mouseMoveByOffset(int xOffset, int yOffset)

Переместить веб-элемент на указанное смещение.

Требует предварительного вызова mouseDown() для активации перетаскивания.

Parameters:
  • xOffset – смещение по оси X в пикселях: положительное — вправо, отрицательное — влево.

  • yOffset – смещение по оси Y в пикселях: положительное — вниз, отрицательное — вверх.

Throws:
  • DraggableException

    если:

    1. Не был вызван метод mouseDown() для активации перетаскивания

    2. Метод вызывается для элемента, отличного от того, на котором было начато перетаскивание

mouseUp

void mouseUp()

Отпустить левую кнопку мыши.

Требует предварительного вызова mouseDown() для активации перетаскивания.

Throws:
  • DraggableException

    если:

    1. Не был вызван метод mouseDown() для активации перетаскивания

    2. Метод вызывается для элемента, отличного от того, на котором было начато перетаскивание