scrollIntoView

Przewiń element do obszaru widoczności zarówno dla aplikacji Desktop/Mobile Web JAK I aplikacji natywnych na urządzeniach mobilnych.

informacja

Przewijanie dla natywnych aplikacji mobilnych odbywa się na podstawie komendy mobilnej swipe.

Ta komenda działa tylko z następującymi zaktualizowanymi komponentami:

• Serwer Appium (wersja 2.0.0 lub wyższa)
• appium-uiautomator2-driver (dla Androida)
• appium-xcuitest-driver (dla iOS)

Upewnij się, że Twoje lokalne lub chmurowe środowisko Appium jest regularnie aktualizowane, aby uniknąć problemów z kompatybilnością.

Parametry

Nazwa	Typ	Szczegóły
options opcjonalny	object, boolean	opcje dla Element.scrollIntoView(). Domyślnie dla desktop/mobile web: { block: 'start', inline: 'nearest' } Domyślnie dla natywnych aplikacji mobilnych { maxScrolls: 10, scrollDirection: 'down' }
Tylko Desktop/Mobile Web
options.behavior opcjonalny	string	Zobacz Dokumentację MDN. TYLKO-WEB (Desktop/Mobile)
options.block opcjonalny	string	Zobacz Dokumentację MDN. TYLKO-WEB (Desktop/Mobile)
options.inline opcjonalny	string	Zobacz Dokumentację MDN. TYLKO-WEB (Desktop/Mobile)
Tylko natywne aplikacje mobilne
options.direction opcjonalny	string	Może być jednym z down, up, left lub right, domyślnie up. TYLKO-APLIKACJE-NATYWNE-MOBILNE
options.maxScrolls opcjonalny	number	Maksymalna liczba przewinięć, po której przestanie szukać elementu, domyślnie 10. TYLKO-APLIKACJE-NATYWNE-MOBILNE
options.duration opcjonalny	number	Czas trwania przesunięcia w milisekundach. Domyślnie 1500 ms. Im niższa wartość, tym szybsze przesunięcie. TYLKO-APLIKACJE-NATYWNE-MOBILNE
options.scrollableElement opcjonalny	Element	Element, który jest używany do przewijania. Jeśli nie zostanie dostarczony żaden element, użyje następującego selektora dla iOS -ios predicate string:type == "XCUIElementTypeApplication" oraz następującego dla Androida //android.widget.ScrollView'. Jeśli więcej elementów pasuje do domyślnego selektora, domyślnie wybierze pierwszy pasujący element. TYLKO-APLIKACJE-NATYWNE-MOBILNE
options.percent opcjonalny	number	Procent (domyślnego) przewijalnego elementu do przesunięcia. Jest to wartość między 0 a 1. Domyślnie 0.95. NIGDY nie przesuwaj z dokładnej góry|dołu|lewej|prawej strony ekranu, możesz wywołać np. pasek powiadomień lub inne funkcje systemu operacyjnego/aplikacji, co może prowadzić do nieoczekiwanych wyników. TYLKO-APLIKACJE-NATYWNE-MOBILNE

Przykłady

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