Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

::scroll-button() — controlli di scorrimento CSS

Lo pseudoelemento ::scroll-button() fornisce un controllo che fa scorrere il contenitore associato di una «pagina». L’argomento sceglie una direzione, content genera il controllo e :disabled segnala un limite di scorrimento.

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

Sintassi

::scroll-button( '*' | <scroll-button-direction> )
<scroll-button-direction> = up | down | left | right | block-start | block-end | inline-start | inline-end | prev | next

::scroll-button() indica una famiglia di pseudoelementi; un argomento vuoto non è un selettore valido. La forma ::scroll-button( <scroll-button-direction> ) seleziona uno dei quattro pulsanti al massimo appartenenti a un contenitore scorrevole. Un pulsante viene generato quando il valore calcolato di content non è none. Se il pulsante è associato a un elemento diverso dall’elemento radice, la sua casella precede quella del contenitore come casella sorella, anziché trovarsi nel contenuto scorrevole. Se il pulsante è associato all’elemento radice, la sua casella si trova invece all’interno della casella di tale elemento.

up, down, left e right indicano direzioni fisiche. block-start, block-end, inline-start e inline-end dipendono dalla modalità di scrittura. prev e next selezionano l’inizio e la fine dell’asse con più pagine scorrevoli, confrontando la dimensione dell’overflow divisa per quella dell’area di scorrimento. In caso di parità viene scelto l’asse di blocco.

La grammatica della bozza più recente, ::scroll-button( '*' | <scroll-button-direction> ), aggiunge ::scroll-button(*) per selezionare tutti e quattro i pulsanti. In CSS, non racchiudere l’asterisco tra virgolette. La precedente pubblicazione W3C fornita specifica solo la forma direzionale; la bozza può cambiare.

Per impostazione predefinita, i pulsanti possono ricevere il focus ed essere attivati. L’attivazione fa scorrere di una «pagina», non di una distanza in pixel garantita. :disabled corrisponde al pulsante quando non è possibile continuare a scorrere nella sua direzione. Verifica l’esempio localmente nel browser di destinazione e mantieni lo scorrimento ordinario come alternativa.

Esempi

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

Risultato

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.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti