.. java:import:: org.openqa.selenium WebElement .. java:import:: ru.bitec.gs.automation.client.html.geometry BoundingClientRect .. java:import:: ru.bitec.gs.automation.client.ui AbstractUiElement ScrollBar ========= .. java:package:: ru.bitec.gs.automation.client.ui.layout :noindex: .. java:type:: public final class ScrollBar extends AbstractUiElement .. versionadded:: 1.2.1 Полоса прокрутки элемента интерфейса. И у грида, и у компоновщика полоса прокрутки - нативная прокрутка dom-элемента-контейнера. У компоновщика она появляется, когда в разметке представления задан атрибут ``minHeight`` , а места под компоновщик меньше. Например, компоновщик с ``minHeight="700"`` в окне, где под него осталось 500 пикселей, не сжимает содержимое, а оставляет его высотой 700 пикселей и прокручивается сам. Поэтому обе полосы описываются одним классом, а направление выбирает, какие свойства контейнера читаются и меняются. .. seealso:: | :java:ref:`Grid.getScrollBar(ru.bitec.gs.automation.client.ui.layout.ScrollBar.Orientation) ` | :java:ref:`Composer.scrollBar() ` Constructors ------------ ScrollBar ^^^^^^^^^ .. java:constructor:: public ScrollBar(AbstractUiElement parent, WebElement webElement, ScrollBar.Orientation orientation) :outertype: ScrollBar Создать полосу прокрутки по dom-элементу-контейнеру. Конструктор открыт потому, что полосу находят элементы из разных пакетов (грид и компоновщик), и каждый знает свой признак полосы в dom-модели. Тестам полоса выдаётся этими элементами. :param parent: элемент интерфейса, которому принадлежит полоса :param webElement: dom-элемент, содержимое которого прокручивается :param orientation: направление прокрутки Methods ------- getContentSize ^^^^^^^^^^^^^^ .. java:method:: public int getContentSize() :outertype: ScrollBar Получить полный размер прокручиваемого содержимого (``scrollHeight`` или ``scrollWidth`` ). Вместе с :java:ref:`getVisibleSize() ` показывает, нужна ли прокрутка вообще и сколько осталось до конца. :return: размер содержимого в пикселях getPosition ^^^^^^^^^^^ .. java:method:: public int getPosition() :outertype: ScrollBar Получить текущее смещение прокрутки (``scrollTop`` или ``scrollLeft`` ). :return: смещение прокрутки в пикселях, 0 - в начале содержимого getRect ^^^^^^^ .. java:method:: public BoundingClientRect getRect() :outertype: ScrollBar Получить положение и размер полосы прокрутки в окне браузера. :return: прямоугольник полосы прокрутки .. seealso:: | :java:ref:`Geometry.getScrollBarRect(ru.bitec.gs.automation.client.WithWebElement,boolean) ` getVisibleSize ^^^^^^^^^^^^^^ .. java:method:: public int getVisibleSize() :outertype: ScrollBar Получить размер видимой области контейнера (``clientHeight`` или ``clientWidth`` ). :return: размер видимой области в пикселях getWidth ^^^^^^^^ .. java:method:: public int getWidth() :outertype: ScrollBar Получить толщину полосы прокрутки в пикселях. :return: место, которое полоса занимает в контейнере, в пикселях. 0, если полоса не занимает места, в том числе когда она наложена поверх содержимого или скрыта стилями scroll ^^^^^^ .. java:method:: public int scroll(double pixels) throws org.openqa.selenium.TimeoutException :outertype: ScrollBar Прокрутить содержимое на указанное количество пикселей и дождаться, пока прокрутка остановится. Положительное значение прокручивает вниз или вправо, отрицательное - вверх или влево. Браузер сам ограничивает позицию границами содержимого, поэтому для прокрутки до края достаточно заведомо большого значения. После установки позиции грид может дорисовывать попавшие в видимую область строки и колонки и сдвигать позицию, поэтому прокрутка считается завершённой, когда позиция совпала на двух соседних опросах. :param pixels: на сколько пикселей прокрутить :throws org.openqa.selenium.TimeoutException: если позиция не перестала меняться за отведённое время :return: смещение прокрутки после остановки, как у :java:ref:`getPosition() `