Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

:lang() — selezionare gli elementi in base alla lingua del contenuto

La pseudoclasse :lang() seleziona gli elementi in base alla lingua del loro contenuto, anche quando questa è determinata da un antenato. Permette di applicare stili specifici per lingua senza aggiungere un attributo lang a ogni elemento.

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

Sintassi

:lang(language-range)
:lang(language-range, language-range, ...)

:lang() è una pseudoclasse funzionale che seleziona un elemento in base alla lingua del suo contenuto. La notazione :lang indica questa pseudoclasse, ma da sola non è un selettore valido: servono le parentesi e un argomento. Il selettore non traduce il testo né rileva la lingua in base alle parole.

In HTML, la lingua può provenire dall’attributo lang di un antenato. Di conseguenza, :lang(pl) può selezionare un elemento privo di un proprio lang, mentre [lang|="pl"] controlla solo l’attributo di quell’elemento. L’attributo lang proprio di un discendente può modificarne la lingua rispetto a quella dell’antenato.

Per gli intervalli di base, :lang(en) corrisponde, tra gli altri, a en e en-US, ma non a eng; il confronto non distingue tra maiuscole e minuscole ASCII. CSS2 e Selectors Level 3 descrivono un singolo argomento. Selectors Level 4 aggiunge elenchi, come :lang(pl, en), e intervalli estesi con caratteri jolly, come :lang("*-Latn"). Un intervallo deve essere un identificatore CSS o una stringa; l’asterisco deve essere racchiuso tra virgolette o sottoposto a escape in modo appropriato. Verifica separatamente il supporto delle estensioni Level 4 nel browser di destinazione.

Nell’esempio, a eredita la lingua pl-PL, quindi corrisponde a :lang(pl) ed è verde. L’elemento b ha il proprio lang="en", quindi non corrisponde e rimane nero. Apri la console del browser per verificare se ciascun elemento corrisponde al selettore e vedere il suo colore calcolato. I risultati vengono scritti solo nella console.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Matching inherited content language</title>
  <style>
    p { color: rgb(0, 0, 0); }
    p:lang(pl) { color: rgb(0, 128, 0); }
  </style>
</head>
<body>
  <div lang="pl-PL">
    <p id="a">Dzień dobry.</p>
    <p id="b" lang="en">Good morning.</p>
  </div>
  <script>
    for (const id of ['a', 'b']) {
      const paragraph = document.getElementById(id);
      console.log(`${id}: ${paragraph.matches(':lang(pl)')}, ${getComputedStyle(paragraph).color}`);
    }
  </script>
</body>
</html>

Risultato

a: true, rgb(0, 128, 0)
b: false, rgb(0, 0, 0)

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti