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

CKTIS / CSS

:lang() — selecionar elementos pela língua do conteúdo

A pseudoclasse :lang() seleciona elementos pela língua do seu conteúdo, incluindo quando esta é determinada por um antepassado. Permite aplicar estilos específicos de uma língua sem adicionar um atributo lang a todos os elementos.

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

Sintaxe

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

:lang() é uma pseudoclasse funcional que seleciona um elemento com base na língua do seu conteúdo. A notação :lang identifica esta pseudoclasse, mas, por si só, não é um seletor válido: são necessários parênteses e um argumento. O seletor não traduz texto nem deteta a língua a partir das palavras.

Em HTML, a língua pode ser herdada do atributo lang de um antepassado. Assim, :lang(pl) pode selecionar um elemento sem lang próprio, enquanto [lang|="pl"] verifica apenas o atributo desse elemento. O atributo lang próprio de um descendente pode alterar a sua língua em relação à do antepassado.

Para intervalos básicos, :lang(en) corresponde, entre outros, a en e en-US, mas não a eng; a comparação não distingue maiúsculas de minúsculas ASCII. CSS2 e Selectors Level 3 descrevem um argumento único. Selectors Level 4 acrescenta listas, como :lang(pl, en), e intervalos alargados com caracteres universais, como :lang("*-Latn"). Um intervalo tem de ser um identificador CSS ou uma cadeia de caracteres; o asterisco tem de estar entre aspas ou ser escapado de forma adequada. Verifique separadamente o suporte das extensões Level 4 no navegador de destino.

No exemplo, a herda a língua pl-PL, pelo que corresponde a :lang(pl) e fica verde. O elemento b tem o seu próprio lang="en", por isso não corresponde e permanece preto. Abra a consola do navegador para verificar se cada elemento corresponde ao seletor e ver a cor calculada. Os resultados só são apresentados na consola.

Exemplos

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

Resultado

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

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