База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

scroll-margin-left — отстояние отляво при превъртане до елемент

scroll-margin-left измества левия край на областта, използвана за подравняване на елемент при превъртане. Не създава обикновено отстояние в оформлението, а помага да се остави място отляво на целта.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

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

Положителна стойност на scroll-margin-left разширява наляво областта за прихващане на елемента при превъртане, а отрицателна стойност измества левия край на тази област навътре. Тази област започва от ограждащия правоъгълник на трансформираното му поле на рамката. За разлика от margin-left, свойството не променя оформлението.

Приема <length>, включително отрицателни стойности, но не и проценти или auto. Началната стойност е 0; свойството не се наследява. Отнася се за физическата лява страна; scroll-margin-inline-start зависи от посоката на писане.

Задайте го на целевия елемент, а scroll-padding-left — на контейнера за превъртане. Прилага се и при превъртане до фрагмент или чрез scrollIntoView(), дори когато прихващането не е включено. Границите на превъртането могат да ограничат разстоянието.

Примерът подравнява целта вляво и оставя 24px. Тест с Chromium 157.0.8103.51 в изолирана среда потвърди очаквания резултат: scrollLeft=176; gap=24px.

Примери

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

Резултат

scrollLeft=176; gap=24px

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници