CKTIS / CSS
scroll-behavior — sposób przewijania
Właściwość scroll-behavior określa, czy przewijanie wywołane nawigacją lub API jest natychmiastowe, czy płynne. Nie steruje bezpośrednim przewijaniem przez użytkownika.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
scroll-behavior: auto | smooth;scroll-behavior dotyczy kontenerów przewijania. Początkowe auto oznacza przewinięcie natychmiastowe; smooth oznacza ruch o czasie trwania i przebiegu ustalanym przez przeglądarkę. Właściwość nie jest dziedziczona ani animowalna.
Obejmuje nawigację, API przewijania oraz operacje przyciągania przewijania niewywołane przez użytkownika. Nie zmienia bezpośredniego przewijania gestem lub kółkiem. Ustawiona na html steruje widokiem strony; ustawienie na body nie jest przenoszone na ten widok. Przeglądarka może ją zignorować.
W przykładzie overflow: auto i ograniczona wysokość tworzą kontener przewijania. Wywołanie scrollTo() z behavior: 'auto' korzysta z obliczonego scroll-behavior, więc może uruchomić płynny ruch. To nie to samo co CSS scroll-behavior: auto. Sprawdzaj położenie końcowe, nie stały czas animacji.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>scroll-behavior</title>
<style>
#panel {
height: 120px;
overflow: auto;
scroll-behavior: smooth;
border: 1px solid;
}
#content { height: 600px; }
</style>
<button id="go" type="button">Scroll to 240px</button>
<div id="panel" tabindex="0" aria-label="Scrollable example">
<div id="content">Scrollable content</div>
</div>
<script>
const panel = document.getElementById('panel');
document.getElementById('go').addEventListener('click', () => {
panel.scrollTo({ top: 240, behavior: 'auto' });
});
</script>
</html>Wynik
After scrolling completes without interruption: panel.scrollTop === 240. No console output.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.