Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

:lang() — sélectionner des éléments selon la langue du contenu

La pseudo-classe :lang() sélectionne des éléments selon la langue de leur contenu, y compris lorsque celle-ci est déterminée par un ancêtre. Elle permet d’appliquer des styles propres à une langue sans ajouter d’attribut lang à chaque élément.

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

Syntaxe

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

:lang() est une pseudo-classe fonctionnelle qui sélectionne un élément en fonction de la langue de son contenu. La notation :lang désigne cette pseudo-classe, mais ne constitue pas à elle seule un sélecteur valide : des parenthèses et un argument sont nécessaires. Le sélecteur ne traduit pas le texte et ne détecte pas la langue à partir des mots.

En HTML, la langue peut provenir de l’attribut lang d’un ancêtre. Ainsi, :lang(pl) peut sélectionner un élément dépourvu de son propre attribut lang, tandis que [lang|="pl"] vérifie uniquement l’attribut de cet élément. L’attribut lang propre à un descendant peut modifier sa langue par rapport à celle de son ancêtre.

Pour les plages de base, :lang(en) correspond notamment à en et à en-US, mais pas à eng ; la comparaison ne tient pas compte de la casse ASCII. CSS2 et Selectors Level 3 décrivent un argument unique. Selectors Level 4 ajoute des listes, comme :lang(pl, en), et des plages étendues avec jokers, comme :lang("*-Latn"). Une plage doit être un identifiant CSS ou une chaîne ; un astérisque doit être entre guillemets ou correctement échappé. Vérifiez séparément la prise en charge des extensions Level 4 dans le navigateur cible.

Dans l’exemple, a hérite de la langue pl-PL, correspond donc à :lang(pl) et apparaît en vert. L’élément b possède son propre lang="en" : il ne correspond pas et reste noir. Ouvrez la console du navigateur pour vérifier si chaque élément correspond au sélecteur et voir sa couleur calculée. Les résultats ne s’affichent que dans la console.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources