اسکرول به دیدِ عنصر

اسکرول کردن عنصر به داخل صفحه نمایش برای وب دسکتاپ/موبایل و اپلیکیشن‌های بومی موبایل.

اطلاعات

اسکرول کردن برای اپلیکیشن‌های بومی موبایل بر اساس دستور موبایلی swipe انجام می‌شود.

این دستور فقط با اجزای به‌روز شده زیر کار می‌کند:

• سرور Appium (نسخه 2.0.0 یا بالاتر)
• appium-uiautomator2-driver (برای اندروید)
• appium-xcuitest-driver (برای iOS)

مطمئن شوید که محیط Appium محلی یا مبتنی بر ابر شما به طور منظم به‌روزرسانی می‌شود تا از مشکلات سازگاری جلوگیری شود.

پارامترها

نام	نوع	جزئیات
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.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')
    });
});