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

CKTIS / CSS

A declaração antiga `clip: rect(0 0 0 0)` em `.sr-only`

Os quatro zeros da antiga declaração `clip: rect(0 0 0 0)` não deixam nenhuma área visível. Uma classe `.sr-only` tira partido deste efeito para ocultar texto sem o tornar inacessível aos leitores de ecrã.

Versão: Current CSS specifications; browser support varies by feature

Sintaxe

/* Historical form: accepted by some browsers for compatibility */
clip: rect(0 0 0 0);
/* Standard syntax for the deprecated property */
clip: rect(0, 0, 0, 0);
/* Modern clipping property */
clip-path: inset(50%);

.sr-only é um nome de classe convencional, não uma funcionalidade nativa de CSS. A classe oculta texto visualmente, mas mantém-no disponível para tecnologias de apoio. Não a substituas por display: none ou visibility: hidden se os leitores de ecrã ainda precisarem de aceder ao texto.

Em HTML, a propriedade obsoleta clip aplica-se com position: absolute ou position: fixed, mas não com position: relative. A antiga função rect() indica os limites pela ordem superior, direito, inferior e esquerdo. Os limites superior e inferior são medidos a partir do topo da caixa; os limites direito e esquerdo, a partir do lado esquerdo. Quatro zeros dão largura e altura nulas, pelo que nada fica visível. clip: auto não recorta.

A forma rect(0 0 0 0), com espaços, existe por compatibilidade; os navegadores não são obrigados a aceitá-la. Em código antigo, usa vírgulas: rect(0, 0, 0, 0). Não mistures separadores. O rect() antigo de clip é diferente do rect() moderno do tipo <basic-shape>.

Em código novo, usa clip-path: inset(50%): cada limite avança para dentro metade da dimensão correspondente, sem deixar área visível. No exemplo, clip é uma declaração de recurso separada; as dimensões de 1px e overflow: hidden limitam a caixa e o seu transbordo. Não ocultes assim um controlo inteiro que possa receber o foco, a menos que fique visível com :focus, como uma ligação para saltar diretamente para o conteúdo principal.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Visually hidden button text</title>
  <style>
    .sr-only {
      position: absolute;
      width: 1px;
      height: 1px;
      overflow: hidden;
      white-space: nowrap;
      clip: rect(0, 0, 0, 0);
      clip-path: inset(50%);
    }
  </style>
</head>
<body>
  <button type="button">Save<span class="sr-only"> current draft</span></button>
  <script>
    const button = document.querySelector('button');
    const suffix = button.querySelector('.sr-only');
    const style = getComputedStyle(suffix);
    const legacyClip = style.position === 'absolute' &&
      style.clip === 'rect(0px, 0px, 0px, 0px)';
    const modernClip = style.clipPath === 'inset(50%)';

    if (!legacyClip && !modernClip) {
      throw new Error('The button suffix has no zero-area clip.');
    }

    const visibleText = button.firstChild.textContent.trim();
    // The expected name comes from the button's contents, not the accessibility tree.
    const expectedName = button.textContent.replace(/\s+/g, ' ').trim();
    console.log(`Visible button text: ${visibleText}\nExpected accessible name: ${expectedName}`);
  </script>
</body>
</html>

Resultado

Visible button text: Save
Expected accessible name: Save current draft

O botão mostra apenas «Save», mas o nome acessível esperado é «Save current draft». Confirma o nome no painel de acessibilidade do navegador; o aspeto visual não basta.

Lições relacionadas

  • CSS · Lição 24 · Avançado · Versão: 2

Fontes