Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

scroll-margin-block — logický okraj posouvání

scroll-margin-block nastavuje okraje na začátku a konci osy bloku kolem cíle posouvání, aniž by měnila rozložení prvků.

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

Syntaxe

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

scroll-margin-block je zkrácený zápis vlastností scroll-margin-block-start a scroll-margin-block-end. Jedna délka nastaví oba okraje; dvě určují nejprve začátek a potom konec. Obě hodnoty jsou zpočátku 0; vlastnost se nedědí. Procenta a auto nejsou platné; záporné délky jsou povoleny.

Směr osy závisí na writing-mode: při horizontal-tb jde o horní a dolní okraj. Vlastnost mění oblast používanou k přichytávání a k posunutí cíle do zorného pole, nikoli rozestupy v rozložení jako margin. Na rozdíl od scroll-padding-block se nastavuje na cíli, nikoli na kontejneru.

Příklad používá scrollIntoView() bez přichytávání. Zarovnání start využívá 24px; 8px se týká konce. Po kliknutí na tlačítko se zobrazí scrollTop: 216.

Příklady

<!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>

Výsledek

scrollTop: 216

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje