scrollIntoView

Przewiń element do widoku zarówno dla Desktop/Mobile Web ORAZ Natywnych Aplikacji Mobilnych.

informacja

Przewijanie dla Natywnych Aplikacji Mobilnych jest realizowane na podstawie mobilnej komendy swipe.

Użycie

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

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 Natywnej Aplikacji Mobilnej { maxScrolls: 10, scrollDirection: 'down' }
Tylko Desktop/Mobile Web
options.behavior opcjonalny	string	Zobacz MDN Reference. TYLKO-WEB (Desktop/Mobile)
options.block opcjonalny	string	Zobacz MDN Reference. TYLKO-WEB (Desktop/Mobile)
options.inline opcjonalny	string	Zobacz MDN Reference. TYLKO-WEB (Desktop/Mobile)
Tylko Natywne Aplikacje Mobilne
options.direction opcjonalny	string	Może być jednym z down, up, left lub right, domyślnie jest up. TYLKO-NATYWNE-APLIKACJE-MOBILNE
options.maxScrolls opcjonalny	number	Maksymalna liczba przewinięć do momentu zatrzymania wyszukiwania elementu, domyślnie jest 10. TYLKO-NATYWNE-APLIKACJE-MOBILNE
options.duration opcjonalny	number	Czas trwania przesunięcia w milisekundach. Domyślnie to 1500 ms. Im niższa wartość, tym szybsze przesunięcie. TYLKO-NATYWNE-APLIKACJE-MOBILNE
options.scrollableElement opcjonalny	Element	Element używany do przewijania. Jeśli nie podano elementu, zostanie użyty następujący selektor dla iOS -ios predicate string:type == "XCUIElementTypeApplication" oraz następujący dla Androida //android.widget.ScrollView'. Jeśli więcej elementów pasuje do domyślnego selektora, domyślnie zostanie wybrany pierwszy pasujący element. TYLKO-NATYWNE-APLIKACJE-MOBILNE
options.percent opcjonalny	number	Procent (domyślnego) przewijalnego elementu do przesunięcia. Jest to wartość między 0 a 1. Domyślnie to 0.95. NIGDY nie przesuwaj z dokładnego górnego|dolnego|lewego|prawego brzegu ekranu, możesz wywołać na przykład pasek powiadomień lub inne funkcje systemu operacyjnego/aplikacji, co może prowadzić do nieoczekiwanych rezultatów. TYLKO-NATYWNE-APLIKACJE-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')
    });
});