التمرير إلى العرض

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

معلومات

يتم التمرير لتطبيقات الجوال الأصلية بناءً على أمر swipe للجوال.

الاستخدام

$(selector).scrollIntoView({ behavior, block, inline, direction, maxScrolls, duration, scrollableElement, percent })

المعاملات

الاسم	النوع	التفاصيل
options اختياري	object, boolean	خيارات لـ Element.scrollIntoView(). الافتراضي لسطح المكتب/ويب الجوال: { block: 'start', inline: 'nearest' } الافتراضي لتطبيق الجوال الأصلي { maxScrolls: 10, scrollDirection: 'down' }
سطح المكتب/ويب الجوال فقط
options.behavior اختياري	string	انظر مرجع MDN. للويب فقط (سطح المكتب/الجوال)
options.block اختياري	string	انظر مرجع MDN. للويب فقط (سطح المكتب/الجوال)
options.inline اختياري	string	انظر مرجع MDN. للويب فقط (سطح المكتب/الجوال)
تطبيق الجوال الأصلي فقط
options.direction اختياري	string	يمكن أن يكون أحد down أو up أو left أو right، الافتراضي هو up. لتطبيق-الجوال-الأصلي-فقط
options.maxScrolls اختياري	number	الحد الأقصى لعدد التمريرات حتى يتوقف عن البحث عن العنصر، الافتراضي هو 10. لتطبيق-الجوال-الأصلي-فقط
options.duration اختياري	number	المدة بالمللي ثانية للسحب. الافتراضي هو 1500 مللي ثانية. كلما قلت القيمة، زادت سرعة السحب. لتطبيق-الجوال-الأصلي-فقط
options.scrollableElement اختياري	Element	العنصر المستخدم للتمرير داخله. إذا لم يتم توفير عنصر، فسيتم استخدام المحدد التالي لنظام iOS -ios predicate string:type == "XCUIElementTypeApplication" والتالي لنظام Android //android.widget.ScrollView'. إذا تطابقت عناصر أكثر مع المحدد الافتراضي، فسيتم اختيار أول عنصر مطابق افتراضيًا. لتطبيق-الجوال-الأصلي-فقط
options.percent اختياري	number	نسبة العنصر القابل للتمرير (الافتراضي) للسحب. هذه قيمة بين 0 و 1. الافتراضي هو 0.95. لا تقم أبدًا بالسحب من أعلى|أسفل|يسار|يمين الشاشة بالضبط، فقد تؤدي إلى تشغيل شريط الإشعارات أو ميزات نظام التشغيل/التطبيق الأخرى التي يمكن أن تؤدي إلى نتائج غير متوقعة. لتطبيق-الجوال-الأصلي-فقط

أمثلة

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