CKTIS / CSS
::scroll-button() — controlos de deslocamento CSS
O pseudo-elemento ::scroll-button() fornece um controlo que desloca o contentor associado uma «página». O argumento escolhe uma direção, content gera o controlo e :disabled assinala um limite de deslocamento.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
::scroll-button( '*' | <scroll-button-direction> )
<scroll-button-direction> = up | down | left | right | block-start | block-end | inline-start | inline-end | prev | next::scroll-button() designa uma família de pseudo-elementos; um argumento vazio não é um seletor válido. A forma ::scroll-button( <scroll-button-direction> ) seleciona um de, no máximo, quatro botões associados a um contentor com deslocamento. É gerado um botão quando o valor calculado de content não é none. Se o botão tiver origem num elemento que não seja o elemento raiz, a sua caixa fica antes da caixa do contentor, como caixa irmã, e não dentro do conteúdo deslocável. Se tiver origem no elemento raiz, a caixa do botão fica dentro da caixa desse elemento.
up, down, left e right indicam direções físicas. block-start, block-end, inline-start e inline-end dependem do modo de escrita. prev e next selecionam o início e o fim do eixo com mais páginas deslocáveis, comparando o tamanho do excesso dividido pelo tamanho da área de deslocamento. Em caso de empate, é escolhido o eixo de bloco.
A gramática da versão mais recente do rascunho, ::scroll-button( '*' | <scroll-button-direction> ), acrescenta ::scroll-button(*) para selecionar os quatro botões. Em CSS, não coloque o asterisco entre aspas. A publicação W3C anterior fornecida especifica apenas a forma direcional; o rascunho pode mudar.
Por predefinição, os botões podem receber o foco e ser ativados. A ativação desloca uma «página», não uma distância em píxeis garantida. :disabled corresponde ao botão quando não é possível continuar a deslocar na respetiva direção. Verifique o exemplo localmente no navegador de destino e mantenha o deslocamento normal como alternativa.
Exemplos
<!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.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.