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

CKTIS / CSS

scroll-margin-block-start — desplazar un destino de desplazamiento desde el inicio del bloque

scroll-margin-block-start establece un desplazamiento para el área de un destino de desplazamiento en su lado de inicio del bloque. No crea espacio en el diseño; el lado físico afectado depende de writing-mode.

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

Sintaxis

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

scroll-margin-block-start modifica el área de ajuste de desplazamiento de un elemento en su lado de inicio del bloque. Con horizontal-tb es la parte superior; con vertical-rl, el lado derecho. A diferencia de margin, no separa los elementos en el diseño.

Acepta un <length>, incluidas las longitudes negativas, pero no porcentajes ni auto. Su valor inicial es 0 y no se hereda. Establécela en el elemento de destino; en cambio, scroll-padding-block-start corresponde al contenedor de desplazamiento.

Esta área debería tenerse en cuenta en la navegación por fragmentos y con scrollIntoView(), incluso si el ajuste de desplazamiento no está activado. El intervalo de desplazamiento disponible limita la separación que se puede alcanzar.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-block-start</title>
<style>
  #scroller {
    height: 160px;
    overflow: auto;
    writing-mode: horizontal-tb;
  }
  .space { height: 240px; }
  #target {
    height: 40px;
    scroll-margin-block-start: 24px;
    background: gold;
  }
</style>
<button id="go">Scroll</button>
<div id="scroller">
  <div class="space"></div>
  <div id="target">Target</div>
  <div class="space"></div>
</div>
<output id="result"></output>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  document.getElementById('go').onclick = () => {
    target.scrollIntoView({ block: 'start', behavior: 'instant' });
    document.getElementById('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