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')
    });
});