Saltar al contenido principal

scrollIntoView

Desplaza el elemento a la vista para Web de Escritorio/Móvil Y Aplicaciones Nativas Móviles.

información

El desplazamiento para Aplicaciones Nativas Móviles se realiza basándose en el comando móvil swipe.

Este comando solo funciona con los siguientes componentes actualizados:

  • Servidor Appium (versión 2.0.0 o superior)
  • appium-uiautomator2-driver (para Android)
  • appium-xcuitest-driver (para iOS)

Asegúrate de que tu entorno Appium local o en la nube se actualice regularmente para evitar problemas de compatibilidad.

Parámetros
NombreTipoDetalles
options
opcional
object, booleanopciones para Element.scrollIntoView(). Predeterminado para web escritorio/móvil:
{ block: 'start', inline: 'nearest' }
Predeterminado para Aplicación Nativa Móvil
{ maxScrolls: 10, scrollDirection: 'down' }
Solo Web Escritorio/Móvil
options.behavior
opcional
stringVer Referencia MDN.
SOLO-WEB (Escritorio/Móvil)
options.block
opcional
stringVer Referencia MDN.
SOLO-WEB (Escritorio/Móvil)
options.inline
opcional
stringVer Referencia MDN.
SOLO-WEB (Escritorio/Móvil)
Solo Aplicación Nativa Móvil
options.direction
opcional
stringPuede ser uno de down, up, left o right, por defecto es up.
SOLO-APLICACIÓN-NATIVA-MÓVIL
options.maxScrolls
opcional
numberLa cantidad máxima de desplazamientos hasta que dejará de buscar el elemento, por defecto es 10.
SOLO-APLICACIÓN-NATIVA-MÓVIL
options.duration
opcional
numberLa duración en milisegundos para el deslizamiento. El valor predeterminado es 1500 ms. Cuanto menor sea el valor, más rápido será el deslizamiento.
SOLO-APLICACIÓN-NATIVA-MÓVIL
options.scrollableElement
opcional
ElementElemento que se utiliza para desplazarse dentro. Si no se proporciona ningún elemento, utilizará el siguiente selector para iOS -ios predicate string:type == "XCUIElementTypeApplication" y el siguiente para Android //android.widget.ScrollView'. Si más elementos coinciden con el selector predeterminado, entonces por defecto seleccionará el primer elemento coincidente.
SOLO-APLICACIÓN-NATIVA-MÓVIL
options.percent
opcional
numberEl porcentaje del elemento desplazable (predeterminado) para deslizar. Este es un valor entre 0 y 1. El valor predeterminado es 0.95.
NUNCA deslices desde el extremo superior|inferior|izquierdo|derecho de la pantalla, podrías activar por ejemplo la barra de notificaciones u otras características del SO/App que pueden conducir a resultados inesperados.
SOLO-APLICACIÓN-NATIVA-MÓVIL
Ejemplos
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