Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

scroll-margin-block — margen de desplazamiento lógico

scroll-margin-block establece márgenes al principio y al final del eje de bloque alrededor de un destino de desplazamiento, sin cambiar la disposición de los elementos.

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

Sintaxis

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

scroll-margin-block es una forma abreviada de scroll-margin-block-start y scroll-margin-block-end. Un valor de longitud establece ambos extremos; dos valores indican primero el principio y después el final. Ambos son inicialmente 0; la propiedad no se hereda. Los porcentajes y auto no son válidos; se permiten longitudes negativas.

La dirección del eje depende de writing-mode: con horizontal-tb, se refiere a la parte superior e inferior. La propiedad cambia el área que se utiliza para el ajuste de desplazamiento y para desplazar un destino hasta la zona visible, pero no el espaciado de disposición como margin. A diferencia de scroll-padding-block, se aplica al destino, no al contenedor.

El ejemplo usa scrollIntoView() sin ajuste de desplazamiento. La alineación start usa 24px; 8px corresponde al final. Al hacer clic en el botón, el ejemplo muestra scrollTop: 216.

Ejemplos

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

Resultado

scrollTop: 216

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.

Fuentes