scrollIntoView

Rulla element till synlig vy för Desktop/Mobil Webb OCH Mobila Native-appar.

info

Rullning för Mobila Native-appar görs baserat på mobilkommandot swipe.

Detta kommando fungerar endast med följande uppdaterade komponenter:

• Appium-server (version 2.0.0 eller högre)
• appium-uiautomator2-driver (för Android)
• appium-xcuitest-driver (för iOS)

Se till att din lokala eller molnbaserade Appium-miljö uppdateras regelbundet för att undvika kompatibilitetsproblem.

Parametrar

Namn	Typ	Detaljer
options valfri	object, boolean	alternativ för Element.scrollIntoView(). Standard för desktop/mobil webb: { block: 'start', inline: 'nearest' } Standard för Mobil Native-app { maxScrolls: 10, scrollDirection: 'down' }
Endast Desktop/Mobil Webb
options.behavior valfri	string	Se MDN Referens. ENDAST-WEBB (Desktop/Mobil)
options.block valfri	string	Se MDN Referens. ENDAST-WEBB (Desktop/Mobil)
options.inline valfri	string	Se MDN Referens. ENDAST-WEBB (Desktop/Mobil)
Endast Mobil Native-App
options.direction valfri	string	Kan vara en av down, up, left eller right, standard är up. ENDAST-MOBIL-NATIVE-APP
options.maxScrolls valfri	number	Maximalt antal rullningar tills sökningen efter elementet avbryts, standard är 10. ENDAST-MOBIL-NATIVE-APP
options.duration valfri	number	Varaktighet i millisekunder för svepningen. Standard är 1500 ms. Ju lägre värde, desto snabbare svepning. ENDAST-MOBIL-NATIVE-APP
options.scrollableElement valfri	Element	Element som används för att rulla inom. Om inget element anges kommer den att använda följande väljare för iOS -ios predicate string:type == "XCUIElementTypeApplication" och följande för Android //android.widget.ScrollView'. Om flera element matchar standardväljaren kommer den som standard att välja det första matchande elementet. ENDAST-MOBIL-NATIVE-APP
options.percent valfri	number	Procentandel av det (standard) rullbara 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 av skärmen, du kan utlösa till exempel notifikationsfältet eller andra OS/App-funktioner som kan leda till oväntade resultat. ENDAST-MOBIL-NATIVE-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')
    });
});