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