CKTIS / CSS
scroll-margin-left — espacio a la izquierda al desplazarse hasta un elemento
scroll-margin-left desplaza el borde izquierdo del área que se utiliza para alinear un elemento durante el desplazamiento. No crea un margen normal en el diseño; ayuda a dejar espacio a la izquierda del objetivo.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
scroll-margin-left: <length>;
/* Examples */
scroll-margin-left: 24px;
scroll-margin-left: -8px;
scroll-margin-left: 0;Un valor positivo de scroll-margin-left amplía hacia la izquierda el área de ajuste de desplazamiento de un elemento; un valor negativo mueve el borde izquierdo de esa área hacia dentro. Esa área parte del rectángulo delimitador de su caja de borde transformada. A diferencia de margin-left, esta propiedad no cambia el diseño.
Acepta un <length>, incluidos los valores negativos, pero no porcentajes ni auto. Su valor inicial es 0; no se hereda. Se refiere al lado izquierdo físico; scroll-margin-inline-start depende de la dirección de escritura.
Establécela en el elemento objetivo y usa scroll-padding-left en el contenedor desplazable. También se aplica al desplazarse hasta un fragmento o mediante scrollIntoView(), aunque el ajuste de desplazamiento no esté activado. Los límites de desplazamiento pueden restringir el espacio.
El ejemplo alinea el objetivo a la izquierda y deja 24px. Una prueba con Chromium 157.0.8103.51 en un entorno aislado confirmó el resultado esperado: scrollLeft=176; gap=24px.
Ejemplos
<!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>Resultado
scrollLeft=176; gap=24px
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.