Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

scroll-margin-inline-start — logiczny odstęp przy przewijaniu

scroll-margin-inline-start określa przesunięcie obszaru docelowego przewijania po stronie początku osi inline. Nie tworzy odstępu w układzie, a jego fizyczna strona zależy od kierunku pisma.

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

Składnia

scroll-margin-inline-start: <length>;

scroll-margin-inline-start ustawia przesunięcie krawędzi obszaru przyciągania elementu po stronie inline-start. Wpływa także na przewijanie do elementu bez włączonego przyciągania. W przeciwieństwie do margin-inline-start nie zmienia układu; scroll-padding-inline-start ustawia się natomiast na kontenerze przewijania.

Przyjmuje <length>, również wartości ujemne, ale nie procenty ani auto. Wartość początkowa to 0; właściwość nie jest dziedziczona. Dodatnia wartość rozszerza obszar docelowy po tej stronie.

To kierunek logiczny, nie stała lewa krawędź: przy writing-mode: horizontal-tb początek inline jest po lewej dla direction: ltr, a po prawej dla direction: rtl. Pionowy tryb pisma zmienia odwzorowanie osi.

W przykładzie kliknięcie Scroll to B powinno pozostawić 24 CSS px przed B, bez zmiany rozmieszczenia elementów. Oczekiwane scrollLeft wynosi 176. Zasięg przewijania może ograniczyć żądane wyrównanie, szczególnie przy końcach zawartości.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-inline-start</title>
<style>
  .scroller {
    display: flex;
    width: 240px;
    overflow-x: auto;
    direction: ltr;
    writing-mode: horizontal-tb;
  }
  .item {
    flex: 0 0 200px;
    height: 80px;
    background: #ddd;
  }
  #target {
    scroll-margin-inline-start: 24px;
    background: #9df;
  }
</style>
<button id="go">Scroll to B</button>
<div class="scroller">
  <div class="item">A</div>
  <div class="item" id="target">B</div>
  <div class="item">C</div>
</div>
<script>
  document.getElementById('go').addEventListener('click', () => {
    document.getElementById('target').scrollIntoView({
      behavior: 'instant', block: 'nearest', inline: 'start'
    });
  });
</script>

Wynik

After clicking “Scroll to B”: scroller.scrollLeft = 176; B starts 24 CSS px inside the scroller's left edge.

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

Źródła