Перейти до основного вмісту

scrollIntoView

Прокручування елемента у видиму область для настільних/мобільних веб-додатків ТА нативних мобільних додатків.

інфо

Прокручування для нативних мобільних додатків виконується на основі мобільної команди swipe.

Використання
$(selector).scrollIntoView({ behavior, block, inline, direction, maxScrolls, duration, scrollableElement, percent })
Параметри
НазваТипДеталі
options
необов'язковий
object, booleanпараметри для Element.scrollIntoView(). За замовчуванням для настільних/мобільних веб:
{ block: 'start', inline: 'nearest' }
За замовчуванням для нативних мобільних додатків
{ maxScrolls: 10, scrollDirection: 'down' }
Тільки для настільних/мобільних веб
options.behavior
необов'язковий
stringДивіться MDN Reference.
ТІЛЬКИ-ДЛЯ-ВЕБ (Настільні/Мобільні)
options.block
необов'язковий
stringДивіться MDN Reference.
ТІЛЬКИ-ДЛЯ-ВЕБ (Настільні/Мобільні)
options.inline
необов'язковий
stringДивіться MDN Reference.
ТІЛЬКИ-ДЛЯ-ВЕБ (Настільні/Мобільні)
Тільки для нативних мобільних додатків
options.direction
необов'язковий
stringМоже бути одним з: down, up, left або right, за замовчуванням up.
ТІЛЬКИ-ДЛЯ-НАТИВНИХ-МОБІЛЬНИХ-ДОДАТКІВ
options.maxScrolls
необов'язковий
numberМаксимальна кількість прокручувань, після якої пошук елемента припиняється, за замовчуванням 10.
ТІЛЬКИ-ДЛЯ-НАТИВНИХ-МОБІЛЬНИХ-ДОДАТКІВ
options.duration
необов'язковий
numberТривалість свайпу в мілісекундах. За замовчуванням 1500 мс. Чим менше значення, тим швидший свайп.
ТІЛЬКИ-ДЛЯ-НАТИВНИХ-МОБІЛЬНИХ-ДОДАТКІВ
options.scrollableElement
необов'язковий
ElementЕлемент, який використовується для прокрутки. Якщо елемент не вказано, буде використано наступний селектор для iOS -ios predicate string:type == "XCUIElementTypeApplication" і наступний для Android //android.widget.ScrollView'. Якщо селектору за замовчуванням відповідає кілька елементів, буде обрано перший відповідний елемент.
ТІЛЬКИ-ДЛЯ-НАТИВНИХ-МОБІЛЬНИХ-ДОДАТКІВ
options.percent
необов'язковий
numberВідсоток елемента прокрутки (за замовчуванням) для свайпу. Це значення від 0 до 1. За замовчуванням 0.95.
НІКОЛИ не робіть свайп з точного верху|низу|лівого|правого краю екрану, це може викликати, наприклад, панель сповіщень або інші функції ОС/Додатку, що може призвести до неочікуваних результатів.
ТІЛЬКИ-ДЛЯ-НАТИВНИХ-МОБІЛЬНИХ-ДОДАТКІВ
Приклади
desktop.mobile.web.scrollIntoView.js
it('should demonstrate the desktop/mobile web scrollIntoView command', async () => {
const elem = await $('#myElement');
// scroll to specific element
await elem.scrollIntoView();
// center element within the viewport
await elem.scrollIntoView({ block: 'center', inline: 'center' });
});

mobile.native.app.scrollIntoView.js
it('should demonstrate the mobile native app scrollIntoView command', async () => {
const elem = await $('#myElement');
// scroll to a specific element in the default scrollable element for Android or iOS for a maximum of 10 scrolls
await elem.scrollIntoView();
// Scroll to the left in the scrollable element called '#scrollable' for a maximum of 5 scrolls
await elem.scrollIntoView({
direction: 'left',
maxScrolls: 5,
scrollableElement: $('#scrollable')
});
});

Welcome! How can I help?

WebdriverIO AI Copilot