Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

scroll-margin-block — logiczny margines przewijania

scroll-margin-block określa odsunięcia obszaru docelowego przewijania przy początku i końcu osi blokowej, bez zmiany układu elementów.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate

Składnia

scroll-margin-block: <length>{1,2};

scroll-margin-block to skrót dla scroll-margin-block-start i scroll-margin-block-end. Jedna długość ustawia oba końce; dwie oznaczają kolejno początek i koniec. Początkowo oba wynoszą 0; właściwość nie jest dziedziczona. Procenty i auto są niedozwolone; długości ujemne są dozwolone.

Kierunek osi zależy od writing-mode: przy horizontal-tb chodzi o górę i dół. Właściwość zmienia obszar używany do przyciągania oraz przewijania do celu, nie odstępy układu jak margin. W przeciwieństwie do scroll-padding-block ustawia się ją na celu, nie kontenerze.

Przykład używa scrollIntoView() bez przyciągania. Wyrównanie start wykorzystuje 24px; 8px dotyczy końca. Po kliknięciu przycisku przykład wyświetla scrollTop: 216.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-block</title>
<style>
  #scroller {
    height: 160px;
    overflow: auto;
    writing-mode: horizontal-tb;
  }
  .space { height: 240px; }
  #target {
    height: 40px;
    background: gold;
    scroll-margin-block: 24px 8px;
  }
</style>
<button type="button" id="go">Scroll</button>
<div id="scroller">
  <div class="space"></div>
  <div id="target">Target</div>
  <div class="space"></div>
</div>
<pre id="result"></pre>
<script>
  const scroller = document.querySelector('#scroller');
  const target = document.querySelector('#target');
  document.querySelector('#go').addEventListener('click', () => {
    target.scrollIntoView({ block: 'start', behavior: 'instant' });
    document.querySelector('#result').textContent =
      `scrollTop: ${scroller.scrollTop}`;
  });
</script>

Wynik

scrollTop: 216

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła