Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

:lang() — výběr prvků podle jazyka obsahu

Pseudotřída :lang() vybírá prvky podle jazyka jejich obsahu, včetně případu, kdy je jazyk určen předkem. Umožňuje používat styly specifické pro jazyk bez přidání atributu lang ke každému prvku.

Verze: 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() je funkční pseudotřída, která vybírá prvek podle jazyka jeho obsahu. Zápis :lang tuto pseudotřídu označuje, ale sám o sobě není platným selektorem: jsou potřeba závorky a argument. Selektor nepřekládá text ani neurčuje jazyk podle slov.

V HTML může jazyk pocházet z atributu lang předka. Proto může :lang(pl) vybrat prvek bez vlastního atributu lang, zatímco [lang|="pl"] kontroluje pouze atribut daného prvku. Vlastní atribut lang potomka může změnit jeho jazyk oproti jazyku předka.

U základních rozsahů odpovídá :lang(en) mimo jiné hodnotám en a en-US, nikoli však eng; při porovnání se nerozlišují velká a malá písmena ASCII. CSS2 a Selectors Level 3 popisují jeden argument. Selectors Level 4 přidává seznamy, například :lang(pl, en), a rozšířené rozsahy se zástupnými znaky, například :lang("*-Latn"). Rozsah musí být identifikátor CSS nebo řetězec; hvězdička musí být v uvozovkách nebo správně escapovaná. Podporu rozšíření Level 4 ověřte v cílovém prohlížeči zvlášť.

V příkladu prvek a dědí jazyk pl-PL, takže odpovídá :lang(pl) a je zelený. Prvek b má vlastní lang="en", proto neodpovídá a zůstává černý. Otevřete konzoli prohlížeče a ověřte, zda každý prvek odpovídá selektoru a jakou má vypočtenou barvu. Výsledky se vypisují pouze do konzole.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje