CKTIS / CSS
::scroll-button() — controles de desplazamiento CSS
El pseudoelemento ::scroll-button() proporciona un control que desplaza su contenedor asociado una «página». El argumento selecciona una dirección, content genera el control y :disabled señala un límite de desplazamiento.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
::scroll-button( '*' | <scroll-button-direction> )
<scroll-button-direction> = up | down | left | right | block-start | block-end | inline-start | inline-end | prev | next::scroll-button() es el nombre de una familia de pseudoelementos; un argumento vacío no es un selector válido. La forma ::scroll-button( <scroll-button-direction> ) selecciona uno de los hasta cuatro botones de un contenedor desplazable. Se genera un botón cuando su valor calculado de content no es none. Si el botón se origina en un elemento que no es el raíz, su caja se sitúa antes de la caja del contenedor, como caja hermana, y no dentro de su contenido desplazable. Si se origina en el elemento raíz, la caja del botón se sitúa dentro de la caja de ese elemento.
up, down, left y right indican direcciones físicas. block-start, block-end, inline-start e inline-end dependen del modo de escritura. prev y next seleccionan el inicio y el final del eje con más páginas desplazables; para ello se compara el tamaño del desbordamiento dividido por el tamaño del área de desplazamiento. Si hay empate, se elige el eje de bloque.
La gramática del borrador más reciente, ::scroll-button( '*' | <scroll-button-direction> ), añade ::scroll-button(*) para seleccionar los cuatro botones. En CSS, no se deben poner comillas alrededor del asterisco. La publicación W3C anterior proporcionada solo especifica la forma direccional; el borrador puede cambiar.
De forma predeterminada, los botones pueden recibir el foco y activarse. Al activarlos, se desplaza una «página», no una cantidad de píxeles garantizada. :disabled coincide con el botón cuando no es posible seguir desplazándose en su dirección. Comprueba el ejemplo localmente en el navegador de destino y conserva el desplazamiento normal como alternativa.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Scroll buttons</title>
<style>
.scroller {
width: 240px;
height: 100px;
overflow: auto;
writing-mode: horizontal-tb;
direction: ltr;
border: 1px solid;
}
.content {
height: 500px;
background: linear-gradient(white, lightblue);
}
.scroller::scroll-button(up) { content: "Up"; }
.scroller::scroll-button(down) { content: "Down"; }
.scroller::scroll-button(up):disabled,
.scroller::scroll-button(down):disabled { opacity: 0.4; }
</style>
<div class="scroller" tabindex="0" role="region" aria-label="Scrollable example">
<div class="content">Start</div>
</div>
</html>Resultado
In a supporting browser, Up and Down controls precede the 240px-wide scroller. Initially Up is disabled. Activating Down scrolls downward; at the bottom Down is disabled. The exact distance per activation is browser-dependent.
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.