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