Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

La dichiarazione obsoleta `clip: rect(0 0 0 0)` in `.sr-only`

I quattro zeri della vecchia dichiarazione `clip: rect(0 0 0 0)` non lasciano alcuna area visibile. Una classe `.sr-only` sfrutta questo effetto per nascondere il testo alla vista senza sottrarlo ai lettori di schermo.

Versione: Current CSS specifications; browser support varies by feature

Sintassi

/* 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 è un nome di classe convenzionale, non una funzionalità integrata in CSS. La classe nasconde il testo alla vista lasciandolo disponibile alle tecnologie assistive. Non sostituirla con display: none o visibility: hidden se i lettori di schermo devono ancora poter accedere al testo.

In HTML, la proprietà obsoleta clip si applica con position: absolute o position: fixed, non con position: relative. La sua vecchia funzione rect() indica i lati nell’ordine: alto, destra, basso, sinistra. Le coordinate in alto e in basso si misurano dal bordo superiore del riquadro; quelle a destra e a sinistra dal bordo sinistro. Quattro zeri danno larghezza e altezza nulle: non si vede nulla. clip: auto non ritaglia.

La forma con spazi rect(0 0 0 0) esiste per compatibilità e i browser non sono tenuti ad accettarla. Nel codice legacy usa le virgole: rect(0, 0, 0, 0). Non mescolare i separatori. Il vecchio rect() di clip è distinto dal moderno rect() di tipo <basic-shape>.

Nel codice nuovo usa clip-path: inset(50%): ogni lato si sposta verso l’interno di metà della dimensione corrispondente e non rimane alcuna area. Nell’esempio clip è una dichiarazione di ripiego separata; le dimensioni di 1px e overflow: hidden limitano il riquadro e il suo contenuto eccedente. Non nascondere così un intero controllo che può ricevere il focus, a meno che non torni visibile con :focus, come un link per passare direttamente al contenuto principale.

Esempi

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

Risultato

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

Il pulsante mostra solo «Save», ma il nome accessibile atteso è «Save current draft». Controlla il nome nel pannello di accessibilità del browser: il solo aspetto visivo non basta.

Lezioni correlate

  • CSS · Lezione 24 · Avanzato · Versione: 2

Fonti