Geometry¶
- public class Geometry¶
Added in version 1.2.0.
Added in version 1.2.2: Добавлен
getScrollBarRect(WithWebElement, boolean).Набор вспомогательных средств для взаимодействия с геометрическими характеристиками окна браузера и веб-элементов.
Methods¶
getBoundingClientRect¶
- public BoundingClientRect getBoundingClientRect(WithWebElement withWebElement)¶
Получает информацию о положении и размере веб-элемента на экране.
Внутри метод запускает JavaScript-функцию
element.getBoundingClientRect()прямо в браузере. Эта функция возвращает координаты (x, y) и размеры (ширину и высоту) веб-элемента, а также расстояния от границ окна браузера (viewport) до сторон веб-элемента.- Parameters:
withWebElement – объект, содержащий веб-элемент, для которого нужно получить координаты и размеры.
- Returns:
Объект
BoundingClientRect, содержащий все данные о положении и размере веб-элемента.
getBoundingClientRect¶
- public BoundingClientRect getBoundingClientRect(WebElement webElement)¶
Added in version 1.2.3.
Получить положение и размер dom-элемента относительно области просмотра.
- Parameters:
webElement – dom-элемент
- Returns:
положение и размер элемента
getScrollBarRect¶
- public BoundingClientRect getScrollBarRect(WithWebElement container, boolean isVertical)¶
Added in version 1.2.2.
Получить положение и размер нативной полосы прокрутки контейнера в окне браузера.
Нативная полоса не отдельный dom-элемент, и
getBoundingClientRect()для неё не вызвать. Прямоугольник вычисляется из прямоугольника контейнера, его видимой области и рамки. Вертикальная полоса лежит справа от видимой области, горизонтальная - под ней. Все величины читаются за одно обращение к браузеру, чтобы между чтениями не вклинилась перерисовка. У полосы, которая не занимает места (наложенной поверх содержимого или скрытой стилями), толщина прямоугольника равна 0.- Parameters:
container – объект с dom-элементом, содержимое которого прокручивается
isVertical –
trueдля вертикальной полосы,falseдля горизонтальной
- Returns:
прямоугольник полосы прокрутки
getWindowHeight¶
- public int getWindowHeight()¶
Added in version 1.2.1.
Возвращает высоту видимой области (viewport) окна браузера в пикселях.
В отличие от
WebDriver.Window.getSize()→Dimension.getHeight(), этот метод использует JavaScript и возвращает именно высоту внутренней области окна (без учета рамок, панели инструментов и т.д.).- Returns:
высота viewport (innerHeight) текущего окна браузера.
getWindowWidth¶
- public int getWindowWidth()¶
Возвращает ширину видимой области (viewport) окна браузера в пикселях.
В отличие от
WebDriver.Window.getSize()→Dimension.getWidth(), этот метод использует JavaScript и возвращает именно ширину внутренней области окна (без учета рамок, панели инструментов и т.д.).- Returns:
ширина viewport (innerWidth) текущего окна браузера.
of¶
- public static Geometry of(BrowserContext ctx)¶