Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:lang() — wybór elementów według języka treści

Pseudoklasa :lang() wybiera elementy według języka ich treści, również ustalonego na podstawie przodka. Umożliwia stosowanie stylów językowych bez dodawania atrybutu lang do każdego elementu.

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

Składnia

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

:lang() jest pseudoklasą funkcyjną dopasowującą element na podstawie języka jego treści. Zapis :lang nazywa tę pseudoklasę, ale samodzielnie nie jest poprawnym selektorem: potrzebne są nawiasy i argument. Selektor nie tłumaczy tekstu ani nie rozpoznaje języka na podstawie słów.

W HTML język może pochodzić z atrybutu lang przodka. Dlatego :lang(pl) może dopasować element bez własnego lang, podczas gdy [lang|="pl"] sprawdza wyłącznie atrybut tego elementu. Własny lang potomka może zmienić jego język względem przodka.

Dla podstawowych zakresów :lang(en) dopasowuje między innymi en i en-US, ale nie eng; porównanie nie rozróżnia wielkości liter ASCII. CSS2 i Selectors Level 3 opisują pojedynczy argument. Selectors Level 4 dodaje listy, np. :lang(pl, en), i rozszerzone zakresy z symbolami wieloznacznymi, np. :lang("*-Latn"). Zakres musi być identyfikatorem CSS lub ciągiem znaków; gwiazdkę trzeba ująć w cudzysłowy albo poprzedzić odpowiednią sekwencją ucieczki. Obsługę rozszerzeń Level 4 sprawdzaj oddzielnie w docelowej przeglądarce.

W przykładzie a dziedziczy język pl-PL, więc pasuje do :lang(pl) i jest zielony. Element b ma własne lang="en", więc nie pasuje i pozostaje czarny. Aby sprawdzić dopasowanie i obliczony kolor, otwórz konsolę przeglądarki. Wyniki są wypisywane tylko tam.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła