KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

scroll-margin-block — logische scrollmarge

scroll-margin-block stelt marges aan het begin en einde van de blokas rond een scrollbestemming in, zonder de indeling van elementen te veranderen.

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

Syntax

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

scroll-margin-block is een verkorte schrijfwijze voor scroll-margin-block-start en scroll-margin-block-end. Eén lengtemaat stelt beide kanten in; twee lengtematen geven eerst het begin en daarna het einde aan. Beide waarden zijn aanvankelijk 0; de eigenschap wordt niet overgeërfd. Percentages en auto zijn ongeldig; negatieve lengtematen zijn toegestaan.

De richting van de as hangt af van writing-mode: bij horizontal-tb gaat het om boven en onder. De eigenschap verandert het gebied dat wordt gebruikt voor snapgedrag en om een doel in beeld te scrollen, maar niet de lay-outafstand zoals bij margin. In tegenstelling tot scroll-padding-block hoort deze eigenschap bij het doel en niet bij de container.

Het voorbeeld gebruikt scrollIntoView() zonder snapgedrag. De uitlijning start gebruikt 24px; 8px geldt voor het einde. Als je op de knop klikt, verschijnt scrollTop: 216.

Voorbeelden

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

Resultaat

scrollTop: 216

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen