Vai al contenuto principale

scrollIntoView

Scorrere l'elemento nella viewport sia per Desktop/Mobile Web E App Native Mobile.

informazione

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

Utilizzo
$(selector).scrollIntoView({ behavior, block, inline, direction, maxScrolls, duration, scrollableElement, percent })
Parametri
NomeTipoDettagli
options
opzionale
object, booleanopzioni 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
stringVedi Riferimento MDN.
SOLO-WEB (Desktop/Mobile)
options.block
opzionale
stringVedi Riferimento MDN.
SOLO-WEB (Desktop/Mobile)
options.inline
opzionale
stringVedi Riferimento MDN.
SOLO-WEB (Desktop/Mobile)
Solo App Native Mobile
options.direction
opzionale
stringPuò essere uno tra down, up, left o right, il predefinito è up.
SOLO-APP-NATIVE-MOBILE
options.maxScrolls
opzionale
numberIl numero massimo di scorrimenti prima che si interrompa la ricerca dell'elemento, il predefinito è 10.
SOLO-APP-NATIVE-MOBILE
options.duration
opzionale
numberLa durata in millisecondi per lo swipe. Il predefinito è 1500 ms. Più basso è il valore, più veloce sarà lo swipe.
SOLO-APP-NATIVE-MOBILE
options.scrollableElement
opzionale
ElementElemento 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 sceglierà il primo elemento corrispondente.
SOLO-APP-NATIVE-MOBILE
options.percent
opzionale
numberLa percentuale dell'elemento scorrevole (predefinito) da scorrere. Questo è un valore tra 0 e 1. Il predefinito è 0.95.
MAI scorrere dall'esatto alto|basso|sinistra|destra dello schermo, potresti attivare ad esempio la barra delle notifiche o altre funzionalità del sistema operativo/app che possono portare a risultati inattesi.
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')
});
});

Welcome! How can I help?

WebdriverIO AI Copilot