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

CKTIS / CSS

scroll-marker-group — agrupar marcadores de deslocamento

A propriedade scroll-marker-group ativa um grupo gerado de marcadores de deslocamento e especifica a respetiva posição e modo de interação.

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

Sintaxe

scroll-marker-group: none | [ [ before | after ] || [ links | tabs ] ];

scroll-marker-group aplica-se a contentores de deslocamento. O valor inicial none desativa o grupo; a propriedade não é herdada. before e after colocam a respetiva caixa antes ou depois do contentor. No elemento raiz, passa a ser o primeiro ou o último elemento filho, respetivamente.

A propriedade cria ::scroll-marker-group, não os marcadores individuais: estes exigem ::scroll-marker com um valor content diferente de none. Indicar explicitamente links permite navegar através de ligações, enquanto tabs faz com que os marcadores funcionem como separadores, com uma gestão diferente do foco e da acessibilidade. Omitir o modo, como em scroll-marker-group: after, não seleciona o comportamento de links. || permite um ou ambos os grupos de palavras-chave.

Trata-se de um projeto de especificação, não de uma garantia de suporte. O exemplo verifica a declaração com after, não o modo de interação. Teste separadamente a interação por teclado no seu navegador.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>scroll-marker-group: markers after a scroller</title>
  <style>
    #pages {
      inline-size: 15rem;
      max-inline-size: 100%;
      block-size: 8rem;
      overflow: auto;
      border: 1px solid;
      scroll-marker-group: after;
    }
    .page {
      box-sizing: border-box;
      block-size: 8rem;
      padding: 1rem;
    }
    #pages::scroll-marker-group {
      display: flex;
      gap: 0.75rem;
    }
    .page::scroll-marker {
      content: attr(data-marker);
      padding: 0.25rem;
    }
    .page::scroll-marker:target-current {
      font-weight: bold;
      text-decoration: underline;
    }
  </style>
</head>
<body>
  <div id="pages" role="region" aria-label="Scrollable pages" tabindex="0">
    <div class="page" data-marker="Page 1">Page 1</div>
    <div class="page" data-marker="Page 2">Page 2</div>
    <div class="page" data-marker="Page 3">Page 3</div>
  </div>
  <p id="status" role="status"></p>
  <script>
    const pages = document.getElementById('pages');
    const property = 'scroll-marker-group';
    const supported = CSS.supports(property, 'after');
    const computed = getComputedStyle(pages).getPropertyValue(property).trim();
    document.getElementById('status').textContent = supported
      ? `${property}: after syntax supported.`
      : `${property}: after syntax unsupported. The pages can still be scrolled manually.`;
    const passed = supported ? computed.split(/\s+/).includes('after') : computed === '';
    console.log(`scroll-marker-group declaration check: ${passed ? 'PASS' : 'FAIL'}`);
  </script>
</body>
</html>

Resultado

scroll-marker-group declaration check: PASS

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