glisser

Glisser dans une direction spécifique dans la fenêtre d'affichage ou l'élément pour les applications web pour ordinateur/mobile ET les applications natives mobiles.

info

Le glissement pour les applications natives mobiles est basé sur le protocole d'actions W3C, simulant une pression et un mouvement du doigt. C'est différent de la commande mobile: scrollGesture pour Android ou mobile: scroll pour iOS qui est basée sur le protocole du pilote Appium et est uniquement disponible pour les plateformes mobiles dans le contexte NATIVE.

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 basé sur le cloud est régulièrement mis à jour pour éviter les problèmes de compatibilité.

Glissement basé sur les coordonnées

Évitez d'utiliser les options from et to sauf si absolument nécessaire. Elles sont spécifiques à l'appareil et peuvent ne pas fonctionner de manière cohérente sur tous les appareils. Utilisez l'option scrollableElement pour des glissements fiables à l'intérieur d'un élément.

Paramètres

Nom	Type	Détails
`options` optionnel	`object, boolean`	options pour `browser.swipe()`. Par défaut pour desktop/mobile web : `{ direction: 'up', duration: 1500, percent: 0.95, scrollableElement: WebdriverIO.Element }`
`options.direction` optionnel	`string`	Peut être l'un des suivants : `down`, `up`, `left` ou `right`, la valeur par défaut est `up`. UNIQUEMENT POUR APPLICATIONS NATIVES MOBILES
Bas (Down) Point de départ : Vous placez votre doigt vers le haut de l'écran. Mouvement : Vous glissez votre doigt vers le bas de l'écran. Action : Cela varie selon le contexte : - Sur l'écran d'accueil ou dans les applications, cela fait généralement défiler le contenu vers le haut. - Depuis le bord supérieur, cela ouvre souvent le panneau de notifications ou les paramètres rapides. - Dans les navigateurs ou les applications de lecture, cela peut être utilisé pour faire défiler le contenu.
Gauche (Left) Point de départ : Vous placez votre doigt sur le côté droit de l'écran. Mouvement : Vous glissez votre doigt horizontalement vers la gauche.> Action : La réponse à ce geste dépend de l'application : - Cela peut passer à l'élément suivant dans un carrousel ou un ensemble d'images. - Dans un contexte de navigation, cela pourrait revenir à la page précédente ou fermer la vue actuelle. - Sur l'écran d'accueil, cela passe généralement au bureau virtuel ou à l'écran suivant.
Droite (Right) Point de départ : Vous placez votre doigt sur le côté gauche de l'écran. Mouvement : Vous glissez votre doigt horizontalement vers la droite. Action : Similaire au glissement vers la gauche, mais dans la direction opposée : -- Cela passe souvent à l'élément précédent dans un carrousel ou une galerie. - Peut être utilisé pour ouvrir des menus latéraux ou des tiroirs de navigation dans les applications. - Sur l'écran d'accueil, cela passe généralement au bureau virtuel précédent.
Haut (Up) Point de départ : Vous placez votre doigt vers le bas de l'écran. Mouvement : Vous glissez votre doigt vers le haut de l'écran.> Action : Selon le contexte, différentes actions peuvent se produire : - Sur l'écran d'accueil ou dans une liste, cela fait généralement défiler le contenu vers le bas. - Dans une application en plein écran, cela pourrait ouvrir des options supplémentaires ou le tiroir d'applications. - Sur certaines interfaces, cela pourrait déclencher une action de 'rafraîchissement' ou ouvrir une barre de recherche.
`options.duration` optionnel	`number`	La durée en millisecondes pour le glissement. La valeur par défaut est `1500` ms. Plus la valeur est basse, plus le glissement est rapide.
`options.scrollableElement` optionnel	`Element`	Élément utilisé pour glisser à 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, alors par défaut il choisira le premier élément correspondant. UNIQUEMENT POUR APPLICATIONS NATIVES MOBILES
`options.percent` optionnel	`number`	Le pourcentage de l'élément défilable (par défaut) à glisser. C'est une valeur entre 0 et 1. La valeur par défaut est `0.95`. NE JAMAIS glisser 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 du système d'exploitation/de l'application, ce qui peut entraîner des résultats inattendus. Cela n'a aucun effet si `from` et `to` sont fournis.
Les valeurs ci-dessous n'ont d'effet que si le `scrollableElement` n'est PAS fourni, sinon elles sont ignorées.
`options.from` optionnel	`object`	Les coordonnées x et y du début du glissement. Si un `scrollableElement` est fourni, alors ces coordonnées n'ont aucun effet.
`options.from.x` optionnel	`number`	La coordonnée x du début du glissement.
`options.from.y` optionnel	`number`	La coordonnée y du début du glissement.
`options.to` optionnel	`object`	Les coordonnées x et y de la fin du glissement. Si un `scrollableElement` est fourni, alors ces coordonnées n'ont aucun effet.
`options.to.x` optionnel	`number`	La coordonnée x de la fin du glissement.
`options.to.y` optionnel	`number`	La coordonnée y de la fin du glissement.

Exemples

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

Paramètres​

Exemples​

Paramètres

Exemples