Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

::scroll-marker — marcador de navegação por deslocação

O pseudo-elemento ::scroll-marker cria um controlo que, quando ativado, desloca a vista até ao elemento de origem ou até à coluna correspondente, se tiver origem num pseudo-elemento ::column. Requer um grupo de marcadores num contentor com deslocação.

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

Sintaxe

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

::scroll-marker é um pseudo-elemento, não uma classe de um elemento HTML. O seletor .panel::scroll-marker estiliza um controlo gerado associado a .panel.

Para gerar um marcador, define content com um valor diferente de none. Para gerar um grupo, define scroll-marker-group com um valor diferente de none num antecessor que seja um contentor com deslocação. O marcador é associado ao antecessor mais próximo que tenha um grupo de marcadores gerado. Um contentor intermédio com deslocação, mas sem grupo, não impede a associação ao grupo de um antecessor mais distante. Os marcadores aparecem no ::scroll-marker-group desse antecessor pela ordem do documento. Ao ativar um marcador com origem num elemento, a vista desloca-se até esse elemento. Se o marcador tiver origem num pseudo-elemento ::column, a vista desloca-se até essa coluna, e não até ao elemento que gera as colunas. :target-current seleciona o marcador ativo, que não é necessariamente aquele que tem o foco.

Esta funcionalidade faz parte de um projeto de especificação. Testa o comportamento no navegador de destino; o facto de o seletor ser aceite, por si só, não comprova que a funcionalidade funciona. Mantém o foco visível e a possibilidade de deslocação sem marcadores.

Exemplos

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

Resultado

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.

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.

Fontes