Hoppa till huvudinnehåll

scrollIntoView

Scrolla element till synlig vy för Desktop/Mobil Webb OCH Mobila Applikationer.

info

Scrollning för Mobila Applikationer görs baserat på mobila swipe-kommandot.

Användning
$(selector).scrollIntoView({ behavior, block, inline, direction, maxScrolls, duration, scrollableElement, percent })
Parametrar
NamnTypDetaljer
options
valfri
object, booleanalternativ för Element.scrollIntoView(). Standard för desktop/mobil webb:
{ block: 'start', inline: 'nearest' }
Standard för Mobil App
{ maxScrolls: 10, scrollDirection: 'down' }
Endast Desktop/Mobil Webb
options.behavior
valfri
stringSe MDN Reference.
ENDAST-WEBB (Desktop/Mobil)
options.block
valfri
stringSe MDN Reference.
ENDAST-WEBB (Desktop/Mobil)
options.inline
valfri
stringSe MDN Reference.
ENDAST-WEBB (Desktop/Mobil)
Endast Mobila Applikationer
options.direction
valfri
stringKan vara en av down, up, left eller right, standard är up.
ENDAST-MOBIL-APP
options.maxScrolls
valfri
numberMaximalt antal scrollningar innan sökningen efter elementet avbryts, standard är 10.
ENDAST-MOBIL-APP
options.duration
valfri
numberLängden i millisekunder för svepningen. Standard är 1500 ms. Ju lägre värde, desto snabbare svepning.
ENDAST-MOBIL-APP
options.scrollableElement
valfri
ElementElement som används för att scrolla inom. Om inget element anges kommer följande selektor att användas för iOS -ios predicate string:type == "XCUIElementTypeApplication" och följande för Android //android.widget.ScrollView'. Om flera element matchar standardselektorn kommer den som standard att välja det första matchande elementet.
ENDAST-MOBIL-APP
options.percent
valfri
numberProcentandelen av det (standard) scrollbara elementet att svepa. Detta är ett värde mellan 0 och 1. Standard är 0,95.
ALDRIG svep från exakt topp|botten|vänster|höger på skärmen, du kan trigga till exempel notisfältet eller andra OS/App-funktioner vilket kan leda till oväntade resultat.
ENDAST-MOBIL-APP
Exempel
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