scrollIntoView

Scorri l'elemento nel viewport per Web Desktop/Mobile E App Native per Mobile.

informazione

Lo scorrimento per App Native Mobile viene eseguito sulla base del comando mobile swipe.

Questo comando funziona solo con i seguenti componenti aggiornati:

• Server Appium (versione 2.0.0 o superiore)
• appium-uiautomator2-driver (per Android)
• appium-xcuitest-driver (per iOS)

Assicurati che il tuo ambiente Appium locale o basato su cloud sia regolarmente aggiornato per evitare problemi di compatibilità.

Parametri

Nome	Tipo	Dettagli
options opzionale	object, boolean	opzioni per Element.scrollIntoView(). Predefinito per desktop/mobile web: { block: 'start', inline: 'nearest' } Predefinito per App Native Mobile { maxScrolls: 10, scrollDirection: 'down' }
Solo Desktop/Mobile Web
options.behavior opzionale	string	Vedi Riferimento MDN. SOLO-WEB (Desktop/Mobile)
options.block opzionale	string	Vedi Riferimento MDN. SOLO-WEB (Desktop/Mobile)
options.inline opzionale	string	Vedi Riferimento MDN. SOLO-WEB (Desktop/Mobile)
Solo App Native Mobile
options.direction opzionale	string	Può essere uno tra down, up, left o right, il valore predefinito è up. SOLO-APP-NATIVE-MOBILE
options.maxScrolls opzionale	number	Il numero massimo di scorrimenti fino a quando smetterà di cercare l'elemento, il valore predefinito è 10. SOLO-APP-NATIVE-MOBILE
options.duration opzionale	number	La durata in millisecondi per lo swipe. Il valore predefinito è 1500 ms. Più basso è il valore, più veloce sarà lo swipe. SOLO-APP-NATIVE-MOBILE
options.scrollableElement opzionale	Element	Elemento che viene utilizzato per scorrere all'interno. Se non viene fornito alcun elemento, utilizzerà il seguente selettore per iOS -ios predicate string:type == "XCUIElementTypeApplication" e il seguente per Android //android.widget.ScrollView'. Se più elementi corrispondono al selettore predefinito, per impostazione predefinita verrà selezionato il primo elemento corrispondente. SOLO-APP-NATIVE-MOBILE
options.percent opzionale	number	La percentuale dell'elemento scorrevole (predefinito) da scorrere con swipe. Questo è un valore compreso tra 0 e 1. Il valore predefinito è 0.95. MAI scorrere dall'esatto alto|basso|sinistra|destra dello schermo, potresti attivare per esempio la barra delle notifiche o altre funzionalità del sistema operativo/app che possono portare a risultati imprevisti. SOLO-APP-NATIVE-MOBILE

Esempi

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