CKTIS / CSS
::scroll-button() — commandes de défilement CSS
Le pseudo-élément ::scroll-button() fournit une commande qui fait défiler son conteneur associé d’une « page ». Son argument choisit une direction, content génère la commande et :disabled indique une limite de défilement.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
::scroll-button( '*' | <scroll-button-direction> )
<scroll-button-direction> = up | down | left | right | block-start | block-end | inline-start | inline-end | prev | next::scroll-button() désigne une famille de pseudo-éléments ; un argument vide ne constitue pas un sélecteur valide. La forme ::scroll-button( <scroll-button-direction> ) sélectionne l’un des quatre boutons au maximum associés à un conteneur défilant. Un bouton est généré lorsque sa valeur calculée de content n’est pas none. Si le bouton est associé à un élément autre que l’élément racine, sa boîte précède celle du conteneur au même niveau, au lieu de faire partie de son contenu défilant. Si le bouton est associé à l’élément racine, sa boîte est placée à l’intérieur de la boîte de cet élément.
up, down, left et right indiquent des directions physiques. block-start, block-end, inline-start et inline-end dépendent du mode d’écriture. prev et next sélectionnent le début et la fin de l’axe qui comporte le plus de pages défilables, en comparant la taille du débordement divisée par celle de la zone de défilement. En cas d’égalité, l’axe de bloc est choisi.
La grammaire du brouillon plus récent, ::scroll-button( '*' | <scroll-button-direction> ), ajoute ::scroll-button(*) pour sélectionner les quatre boutons. En CSS, ne mettez pas l’astérisque entre guillemets. L’ancienne publication W3C fournie ne spécifie que la forme directionnelle ; le brouillon peut encore évoluer.
Par défaut, les boutons peuvent recevoir le focus et être activés. L’activation fait défiler d’une « page », et non d’un nombre de pixels garanti. :disabled correspond au bouton lorsqu’il est impossible de continuer à défiler dans sa direction. Vérifiez l’exemple localement dans le navigateur cible et conservez le défilement ordinaire comme solution de repli.
Exemples
<!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>Résultat
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.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.