التمرير السريع

التمرير السريع في اتجاه محدد داخل إطار العرض أو العنصر لكل من تطبيقات سطح المكتب/الويب المحمول و تطبيقات الهاتف المحمول الأصلية.

معلومات

التمرير السريع لتطبيقات الهاتف المحمول الأصلية يعتمد على بروتوكول W3C-actions، محاكياً ضغط الإصبع والحركة. هذا يختلف عن mobile: scrollGesture لنظام Android أو mobile: scroll لنظام iOS وهو الأمر المستند إلى بروتوكول Appium Driver والمتاح فقط لمنصات الهاتف المحمول في سياق NATIVE.

هذا الأمر يعمل فقط مع المكونات التالية المحدثة:

• خادم Appium (الإصدار 2.0.0 أو أعلى)
• appium-uiautomator2-driver (لنظام Android)
• appium-xcuitest-driver (لنظام iOS)

تأكد من تحديث بيئة Appium المحلية أو السحابية بانتظام لتجنب مشاكل التوافق.

التمرير السريع بناءً على الإحداثيات

تجنب استخدام خيارات from و to إلا إذا كان ذلك ضرورياً للغاية. هذه خاصة بالجهاز وقد لا تعمل بشكل متسق عبر الأجهزة. استخدم خيار scrollableElement للحصول على تمريرات سريعة موثوقة داخل العنصر.

المعلمات

الاسم	النوع	التفاصيل
options اختياري	object, boolean	خيارات لـ browser.swipe(). الإعداد الافتراضي لسطح المكتب/الويب المحمول: { direction: 'up', duration: 1500, percent: 0.95, scrollableElement: WebdriverIO.Element }
options.direction اختياري	string	يمكن أن يكون down أو up أو left أو right، الافتراضي هو up. للتطبيقات الأصلية للهاتف المحمول فقط
للأسفل نقطة البداية: تضع إصبعك نحو أعلى الشاشة. الحركة: تحرك إصبعك لأسفل نحو أسفل الشاشة. الإجراء: يختلف هذا حسب السياق: - على الشاشة الرئيسية أو في التطبيقات، عادة ما يؤدي إلى تمرير المحتوى لأعلى. - من الحافة العلوية، غالبًا ما يفتح لوحة الإشعارات أو الإعدادات السريعة. - في المتصفحات أو تطبيقات القراءة، يمكن استخدامه للتمرير عبر المحتوى.
لليسار نقطة البداية: تضع إصبعك على الجانب الأيمن من الشاشة. الحركة: تحرك إصبعك أفقيًا إلى اليسار.> الإجراء: يعتمد الرد على هذه الإيماءة على التطبيق: - يمكن أن ينتقل إلى العنصر التالي في شريط التمرير أو مجموعة من الصور. - في سياق التنقل، قد يعود إلى الصفحة السابقة أو يغلق العرض الحالي. - على الشاشة الرئيسية، عادة ما يتبدل إلى سطح المكتب الافتراضي أو الشاشة التالية.
لليمين نقطة البداية: تضع إصبعك على الجانب الأيسر من الشاشة. الحركة: تحرك إصبعك أفقيًا إلى اليمين. الإجراء: مشابه للتمرير لليسار، ولكن في الاتجاه المعاكس: -- غالبًا ما ينتقل إلى العنصر السابق في شريط التمرير أو المعرض. - يمكن استخدامه لفتح القوائم الجانبية أو أدراج التنقل في التطبيقات. - على الشاشة الرئيسية، عادة ما ينتقل إلى سطح المكتب الافتراضي السابق.
للأعلى نقطة البداية: تضع إصبعك نحو أسفل الشاشة. الحركة: تحرك إصبعك للأعلى نحو أعلى الشاشة.> الإجراء: اعتمادًا على السياق، يمكن أن تحدث إجراءات مختلفة: - على الشاشة الرئيسية أو في قائمة، هذا عادة ما يمرر المحتوى للأسفل. - في تطبيق ملء الشاشة، قد يفتح خيارات إضافية أو درج التطبيق. - في واجهات معينة، يمكن أن يؤدي إلى إجراء "تحديث" أو فتح شريط البحث.
options.duration اختياري	number	مدة التمرير السريع بالمللي ثانية. الافتراضي هو 1500 مللي ثانية. كلما انخفضت القيمة، كلما كان التمرير أسرع.
options.scrollableElement اختياري	Element	العنصر الذي يُستخدم للتمرير داخله. إذا لم يتم توفير عنصر، فسيستخدم المحدد التالي لنظام iOS -ios predicate string:type == "XCUIElementTypeApplication" والتالي لنظام Android //android.widget.ScrollView'. إذا كانت هناك عناصر متعددة تتطابق مع المحدد الافتراضي، فسيتم اختيار العنصر الأول المطابق بشكل افتراضي. للتطبيقات الأصلية للهاتف المحمول فقط
options.percent اختياري	number	النسبة المئوية للعنصر القابل للتمرير (الافتراضي) للتمرير السريع. هذه قيمة بين 0 و 1. الافتراضي هو 0.95. لا تقم أبدًا بالتمرير من الأعلى|الأسفل|اليسار|اليمين بالضبط للشاشة، فقد تؤدي على سبيل المثال إلى ظهور شريط الإشعارات أو ميزات نظام التشغيل/التطبيق الأخرى مما قد يؤدي إلى نتائج غير متوقعة. هذا ليس له تأثير إذا تم توفير from و to.
القيم أدناه فقط لها تأثير إذا كان scrollableElement غير متوفر، وإلا فسيتم تجاهلها.
options.from اختياري	object	إحداثيات x و y لبداية التمرير السريع. إذا تم توفير scrollableElement، فلن يكون لهذه الإحداثيات أي تأثير.
options.from.x اختياري	number	إحداثي x لبداية التمرير السريع.
options.from.y اختياري	number	إحداثي y لبداية التمرير السريع.
options.to اختياري	object	إحداثيات x و y لنهاية التمرير السريع. إذا تم توفير scrollableElement، فلن يكون لهذه الإحداثيات أي تأثير.
options.to.x اختياري	number	إحداثي x لنهاية التمرير السريع.
options.to.y اختياري	number	إحداثي y لنهاية التمرير السريع.

أمثلة

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