Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

::scroll-marker — marqueur de navigation par défilement

Le pseudo-élément ::scroll-marker crée une commande qui, une fois activée, fait défiler jusqu’à son élément d’origine ou, si elle provient d’un pseudo-élément ::column, jusqu’à cette colonne. Il nécessite un groupe de marqueurs sur un conteneur défilant.

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

Syntaxe

selector::scroll-marker { content: "…"; }
selector::scroll-marker:target-current { /* active marker styles */ }

::scroll-marker est un pseudo-élément, et non une classe appliquée à un élément HTML. Le sélecteur .panel::scroll-marker met en forme un contrôle généré associé à .panel.

Pour générer un marqueur, attribuez à content une valeur autre que none. Pour générer un groupe, attribuez à scroll-marker-group une valeur autre que none sur un conteneur défilant ancêtre. Le marqueur est associé à l’ancêtre le plus proche qui possède un groupe de marqueurs généré. Un conteneur défilant intermédiaire dépourvu de groupe n’empêche pas l’association au groupe d’un ancêtre plus éloigné. Les marqueurs apparaissent dans le ::scroll-marker-group de cet ancêtre dans l’ordre du document. L’activation d’un marqueur issu d’un élément fait défiler jusqu’à cet élément. Si le marqueur provient d’un pseudo-élément ::column, son activation fait défiler jusqu’à cette colonne, et non jusqu’à l’élément qui génère les colonnes. :target-current sélectionne le marqueur actif, qui n’est pas nécessairement celui qui a le focus.

Cette fonctionnalité appartient à un projet de spécification. Testez son comportement dans le navigateur cible : le fait que le sélecteur soit accepté ne prouve pas à lui seul que la fonctionnalité marche. Préservez un focus visible et la possibilité de faire défiler sans marqueurs.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Scroll markers</title>
<style>
  .scroller {
    width: 240px;
    height: 120px;
    overflow: auto;
    scroll-marker-group: after;
  }
  .panel {
    height: 120px;
    background: #eee;
  }
  .panel::scroll-marker {
    content: attr(data-label);
    padding: 4px 8px;
    color: #222;
  }
  .scroller::scroll-marker-group {
    display: flex;
    gap: 8px;
    height: 32px;
  }
  .panel::scroll-marker:target-current {
    color: #fff;
    background: #222;
  }
  .panel::scroll-marker:focus-visible {
    outline: 2px solid blue;
  }
</style>
<div class="scroller">
  <section class="panel" data-label="1">Panel 1</section>
  <section class="panel" data-label="2">Panel 2</section>
</div>

Résultat

Expected in a supporting browser: Panel 1 is initially visible, with markers 1 and 2 below the scroller. Activating marker 2 scrolls to Panel 2 and gives marker 2 a dark background.

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.

Sources