Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

scroll-margin-left — lewy odstęp przy przewijaniu do elementu

scroll-margin-left określa przesunięcie lewej krawędzi obszaru używanego do wyrównania elementu przy przewijaniu. Nie tworzy zwykłego marginesu w układzie; pomaga pozostawić miejsce po lewej stronie celu.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

scroll-margin-left: <length>;
/* Examples */
scroll-margin-left: 24px;
scroll-margin-left: -8px;
scroll-margin-left: 0;

Dodatnia wartość scroll-margin-left rozszerza obszar przyciągania elementu w lewo, a ujemna przesuwa jego lewą krawędź do wewnątrz. Obszar ten powstaje z prostokąta ograniczającego jego przekształcone pole obramowania. Właściwość nie zmienia układu jak margin-left.

Przyjmuje <length>, także wartości ujemne, ale nie procenty ani auto. Wartość początkowa to 0; właściwość nie jest dziedziczona. Dotyczy fizycznej lewej strony; scroll-margin-inline-start zależy od kierunku pisma.

Ustaw ją na elemencie docelowym, a scroll-padding-left na kontenerze przewijania. Działa również przy przewijaniu do fragmentu lub przez scrollIntoView(), bez włączonego przyciągania. Granice przewijania mogą ograniczyć odstęp.

Przykład wyrównuje cel do lewej, pozostawiając 24px. Test w odizolowanym środowisku Chromium 157.0.8103.51 potwierdził oczekiwany wynik: scrollLeft=176; gap=24px.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-left</title>
<style>
  #scroller {
    width: 300px;
    overflow-x: auto;
    direction: ltr;
    writing-mode: horizontal-tb;
  }
  .track { display: flex; width: 700px; }
  .before { flex: 0 0 200px; }
  #target {
    flex: 0 0 100px;
    height: 60px;
    background: lightblue;
    scroll-margin-left: 24px;
  }
  .after { flex: 0 0 400px; }
</style>
<div id="scroller">
  <div class="track">
    <div class="before"></div>
    <div id="target">Target</div>
    <div class="after"></div>
  </div>
</div>
<pre id="result"></pre>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  target.scrollIntoView({ behavior: 'instant', block: 'nearest', inline: 'start' });
  requestAnimationFrame(() => {
    const gap = target.getBoundingClientRect().left
      - scroller.getBoundingClientRect().left;
    document.getElementById('result').textContent =
      `scrollLeft=${scroller.scrollLeft}; gap=${gap}px`;
  });
</script>

Wynik

scrollLeft=176; gap=24px

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

Źródła