scrollIntoView
Fait défiler l'élément dans la zone visible pour les applications Web Desktop/Mobile ET les applications natives mobiles.
info
Le défilement pour les applications natives mobiles est basé sur la commande mobile swipe
.
Cette commande ne fonctionne qu'avec les composants à jour suivants :
- Serveur Appium (version 2.0.0 ou supérieure)
appium-uiautomator2-driver
(pour Android)appium-xcuitest-driver
(pour iOS)
Assurez-vous que votre environnement Appium local ou dans le cloud est régulièrement mis à jour pour éviter les problèmes de compatibilité.
Paramètres
Nom | Type | Détails |
---|---|---|
options optionnel | object, boolean | options pour Element.scrollIntoView() . Par défaut pour desktop/mobile web : { block: 'start', inline: 'nearest' } Par défaut pour l'application native mobile { maxScrolls: 10, scrollDirection: 'down' } |
Desktop/Mobile Web uniquement | ||
options.behavior optionnel | string | Voir Référence MDN. WEB UNIQUEMENT (Desktop/Mobile) |
options.block optionnel | string | Voir Référence MDN. WEB UNIQUEMENT (Desktop/Mobile) |
options.inline optionnel | string | Voir Référence MDN. WEB UNIQUEMENT (Desktop/Mobile) |
Application native mobile uniquement | ||
options.direction optionnel | string | Peut être down , up , left ou right , la valeur par défaut est up . APPLICATION-NATIVE-MOBILE UNIQUEMENT |
options.maxScrolls optionnel | number | Le nombre maximum de défilements avant d'arrêter la recherche de l'élément, la valeur par défaut est 10 . APPLICATION-NATIVE-MOBILE UNIQUEMENT |
options.duration optionnel | number | La durée en millisecondes pour le balayage. La valeur par défaut est 1500 ms. Plus la valeur est basse, plus le balayage est rapide.APPLICATION-NATIVE-MOBILE UNIQUEMENT |
options.scrollableElement optionnel | Element | Élément utilisé pour faire défiler à l'intérieur. Si aucun élément n'est fourni, il utilisera le sélecteur suivant pour iOS -ios predicate string:type == "XCUIElementTypeApplication" et le suivant pour Android //android.widget.ScrollView' . Si plusieurs éléments correspondent au sélecteur par défaut, il choisira par défaut le premier élément correspondant. APPLICATION-NATIVE-MOBILE UNIQUEMENT |
options.percent optionnel | number | Le pourcentage de l'élément défilable (par défaut) à balayer. C'est une valeur entre 0 et 1. La valeur par défaut est 0.95 .NE JAMAIS balayer depuis l'extrême haut|bas|gauche|droite de l'écran, vous pourriez déclencher par exemple la barre de notification ou d'autres fonctionnalités de l'OS/App qui peuvent conduire à des résultats inattendus. APPLICATION-NATIVE-MOBILE UNIQUEMENT |
Exemples
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')
});
});