Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

scroll-margin-block — margine di scorrimento logico

scroll-margin-block imposta margini all’inizio e alla fine dell’asse del blocco attorno a una destinazione di scorrimento, senza modificare il layout degli elementi.

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

Sintassi

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

scroll-margin-block è la forma abbreviata di scroll-margin-block-start e scroll-margin-block-end. Una lunghezza imposta entrambi i lati; due lunghezze specificano prima l’inizio e poi la fine. Entrambi i valori sono inizialmente 0; la proprietà non è ereditata. Le percentuali e auto non sono validi; sono ammesse lunghezze negative.

La direzione dell’asse dipende da writing-mode: con horizontal-tb si intendono l’alto e il basso. La proprietà modifica l’area utilizzata per l’aggancio e per portare una destinazione nell’area visibile tramite scorrimento, non la spaziatura del layout come fa margin. A differenza di scroll-padding-block, si applica alla destinazione e non al contenitore.

L’esempio usa scrollIntoView() senza aggancio. L’allineamento start usa 24px; 8px riguarda la fine. Facendo clic sul pulsante, l’esempio mostra scrollTop: 216.

Esempi

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

Risultato

scrollTop: 216

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti