scorrimento

Scorri in una direzione specifica all'interno del viewport o dell'elemento per Applicazioni Web Desktop/Mobile E Applicazioni Native Mobile.

info

Lo scorrimento per le Applicazioni Native Mobile è basato sul protocollo W3C-actions, simulando la pressione e il movimento di un dito. Questo è diverso dal comando mobile: scrollGesture per Android o mobile: scroll per iOS che è basato sul protocollo Appium Driver ed è disponibile solo per piattaforme mobili nel contesto NATIVE.

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à.

Scorrimento basato sulle coordinate

Evita di utilizzare le opzioni from e to a meno che non sia assolutamente necessario. Queste sono specifiche per dispositivo e potrebbero non funzionare in modo coerente su diversi dispositivi. Usa l'opzione scrollableElement per scorrimenti affidabili all'interno di un elemento.

Parametri

Nome	Tipo	Dettagli
`options` opzionale	`object, boolean`	opzioni per `browser.swipe()`. Predefinito per web desktop/mobile: `{ direction: 'up', duration: 1500, percent: 0.95, scrollableElement: WebdriverIO.Element }`
`options.direction` opzionale	`string`	Può essere uno tra `down`, `up`, `left` o `right`, il predefinito è `up`. SOLO-APP-NATIVE-MOBILE
Down Punto di partenza: Posizioni il dito verso la parte superiore dello schermo. Movimento: Fai scorrere il dito verso il basso verso la parte inferiore dello schermo. Azione: Questo varia anche in base al contesto: - Nella schermata iniziale o nelle applicazioni, in genere scorre il contenuto verso l'alto. - Dal bordo superiore, spesso apre il pannello delle notifiche o le impostazioni rapide. - Nei browser o nelle app di lettura, può essere utilizzato per scorrere i contenuti.
Left Punto di partenza: Posizioni il dito sul lato destro dello schermo. Movimento: Fai scorrere il dito orizzontalmente verso sinistra.> Azione: La risposta a questo gesto dipende dall'applicazione: - Può passare all'elemento successivo in un carosello o un insieme di immagini. - In un contesto di navigazione, potrebbe tornare alla pagina precedente o chiudere la vista corrente. - Nella schermata iniziale, di solito passa al desktop o alla schermata virtuale successiva.
Right Punto di partenza: Posizioni il dito sul lato sinistro dello schermo. Movimento: Fai scorrere il dito orizzontalmente verso destra. Azione: Simile allo scorrimento verso sinistra, ma nella direzione opposta: -- Spesso si sposta all'elemento precedente in un carosello o galleria. - Può essere utilizzato per aprire menu laterali o cassetti di navigazione nelle app. - Nella schermata iniziale, in genere passa al desktop virtuale precedente.
Up Punto di partenza: Posizioni il dito verso la parte inferiore dello schermo. Movimento: Fai scorrere il dito verso l'alto verso la parte superiore dello schermo.> Azione: A seconda del contesto, possono verificarsi diverse azioni: - Nella schermata iniziale o in un elenco, questo di solito scorre il contenuto verso il basso. - In un'app a schermo intero, potrebbe aprire opzioni aggiuntive o il cassetto delle applicazioni. - Su determinate interfacce, potrebbe attivare un'azione di 'aggiornamento' o aprire una barra di ricerca.
`options.duration` opzionale	`number`	La durata in millisecondi per lo scorrimento. Il valore predefinito è `1500` ms. Più basso è il valore, più veloce sarà lo scorrimento.
`options.scrollableElement` opzionale	`Element`	Elemento all'interno del quale scorrere. 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 selezionerà il primo elemento corrispondente. SOLO-APP-NATIVE-MOBILE
`options.percent` opzionale	`number`	La percentuale dell'elemento scorrevole (predefinito) da scorrere. Questo è un valore compreso tra 0 e 1. Il valore predefinito è `0,95`. MAI scorrere dall'esatto bordo superiore\|inferiore\|sinistro\|destro dello schermo, potresti attivare ad esempio la barra delle notifiche o altre funzionalità del sistema operativo/app che possono portare a risultati imprevisti. Questo non ha effetto se vengono forniti `from` e `to`.
I valori seguenti hanno effetto SOLO se il `scrollableElement` NON è fornito, altrimenti vengono ignorati.
`options.from` opzionale	`object`	Le coordinate x e y dell'inizio dello scorrimento. Se viene fornito un `scrollableElement`, queste coordinate non hanno effetto.
`options.from.x` opzionale	`number`	La coordinata x dell'inizio dello scorrimento.
`options.from.y` opzionale	`number`	La coordinata y dell'inizio dello scorrimento.
`options.to` opzionale	`object`	Le coordinate x e y della fine dello scorrimento. Se viene fornito un `scrollableElement`, queste coordinate non hanno effetto.
`options.to.x` opzionale	`number`	La coordinata x della fine dello scorrimento.
`options.to.y` opzionale	`number`	La coordinata y della fine dello scorrimento.

Esempi

swipe.js
it('should execute a default swipe', async () => {
    // Default will be a swipe from the bottom to the top, meaning it will swipe UP
    await browser.swipe();
});

swipe.with.options.js
it('should execute a swipe with options', async () => {
    await browser.swipe({
        direction: 'left',                  // Swipe from right to left
        duration: 5000,                     // Last for 5 seconds
        percent: 0.5,                       // Swipe 50% of the scrollableElement
        scrollableElement: $('~carousel'),  // The element to swipe within
    })
});

Parametri​

Esempi​

Parametri

Esempi