ScrollBar

public final class ScrollBar extends AbstractUiElement

Added in version 1.2.1.

Полоса прокрутки элемента интерфейса.

И у грида, и у компоновщика полоса прокрутки - нативная прокрутка dom-элемента-контейнера. У компоновщика она появляется, когда в разметке представления задан атрибут minHeight , а места под компоновщик меньше. Например, компоновщик с minHeight="700" в окне, где под него осталось 500 пикселей, не сжимает содержимое, а оставляет его высотой 700 пикселей и прокручивается сам. Поэтому обе полосы описываются одним классом, а направление выбирает, какие свойства контейнера читаются и меняются.

See also

Grid.getScrollBar(ru.bitec.gs.automation.client.ui.layout.ScrollBar.Orientation)

Constructors

ScrollBar

public ScrollBar(AbstractUiElement parent, WebElement webElement, ScrollBar.Orientation orientation)

Создать полосу прокрутки по dom-элементу-контейнеру.

Конструктор открыт потому, что полосу находят элементы из разных пакетов (грид и компоновщик), и каждый знает свой признак полосы в dom-модели. Тестам полоса выдаётся этими элементами.

Parameters:
  • parent – элемент интерфейса, которому принадлежит полоса

  • webElement – dom-элемент, содержимое которого прокручивается

  • orientation – направление прокрутки

Methods

getContentSize

public int getContentSize()

Получить полный размер прокручиваемого содержимого (scrollHeight или scrollWidth ).

Вместе с getVisibleSize() показывает, нужна ли прокрутка вообще и сколько осталось до конца.

Returns:

размер содержимого в пикселях

getPosition

public int getPosition()

Получить текущее смещение прокрутки (scrollTop или scrollLeft ).

Returns:

смещение прокрутки в пикселях, 0 - в начале содержимого

getRect

public BoundingClientRect getRect()

Получить положение и размер полосы прокрутки в окне браузера.

Returns:

прямоугольник полосы прокрутки

getVisibleSize

public int getVisibleSize()

Получить размер видимой области контейнера (clientHeight или clientWidth ).

Returns:

размер видимой области в пикселях

getWidth

public int getWidth()

Получить толщину полосы прокрутки в пикселях.

Returns:

место, которое полоса занимает в контейнере, в пикселях. 0, если полоса не занимает места, в том числе когда она наложена поверх содержимого или скрыта стилями

scroll

public int scroll(double pixels)

Прокрутить содержимое на указанное количество пикселей и дождаться, пока прокрутка остановится.

Положительное значение прокручивает вниз или вправо, отрицательное - вверх или влево. Браузер сам ограничивает позицию границами содержимого, поэтому для прокрутки до края достаточно заведомо большого значения. После установки позиции грид может дорисовывать попавшие в видимую область строки и колонки и сдвигать позицию, поэтому прокрутка считается завершённой, когда позиция совпала на двух соседних опросах.

Parameters:
  • pixels – на сколько пикселей прокрутить

Throws:
Returns:

смещение прокрутки после остановки, как у getPosition()