scrollIntoView

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

اطلاعات

اسکرول کردن برای اپلیکیشن‌های بومی موبایل بر اساس دستور موبایل 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.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')
    });
});