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:
org.openqa.selenium.TimeoutException– если позиция не перестала меняться за отведённое время
- Returns:
смещение прокрутки после остановки, как у
getPosition()