Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:first-child — pierwszy element wśród rodzeństwa

Pseudoklasa :first-child dopasowuje element, który jest pierwszy wśród swojego rodzeństwa będącego elementami. Nie oznacza „pierwszego elementu danego typu”: p:first-child nie dopasuje akapitu poprzedzonego nagłówkiem.

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

Składnia

:first-child

:first-child to strukturalna pseudoklasa CSS, zapisywana z jednym dwukropkiem, bez argumentów i nawiasów. Nazwa first-child bez dwukropka nie jest zapisem tej pseudoklasy. Selektor p:first-child dopasowuje element p tylko wtedy, gdy nie poprzedza go żaden element rodzeństwa; jest równoważny p:nth-child(1).

Przy ustalaniu pozycji liczą się wyłącznie elementy. Tekst, białe znaki i komentarze nie przesuwają tej pozycji. Nie chodzi o pierwszy element danego typu: jeśli przed p występuje h2, selektor p:first-child nie dopasuje tego akapitu. Do wyboru pierwszego p wśród rodzeństwa służy p:first-of-type.

W selektorze .group > p:first-child znak > dodatkowo wymaga, aby p był bezpośrednim dzieckiem elementu z klasą group. W przykładzie pasuje tylko #selected; #blocked poprzedza nagłówek, a #later poprzedza inny akapit.

CSS Level 2 opisuje tę pseudoklasę jako pierwsze dziecko innego elementu. Selectors Level 4 definiuje ją jako pierwszy element wśród rodzeństwa z uwzględnieniem jego samego, więc element bez rodzica również może pasować. Nie należy dodawać wymagania posiadania rodzica do współczesnej definicji.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:first-child example</title>
<style>
  .group > p:first-child { font-weight: bold; }
</style>
<div class="group">
  <h2>Heading</h2>
  <p id="blocked">Not selected</p>
</div>
<div class="group">
  <!-- Comments and whitespace do not affect the position. -->
  <p id="selected">Selected</p>
  <p id="later">Not selected</p>
</div>
<pre id="result"></pre>
<script>
  const matches = document.querySelectorAll('.group > p:first-child');
  document.getElementById('result').textContent =
    Array.from(matches, element => element.id).join(', ');
</script>
</html>

Wynik

selected

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

Źródła