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

CKTIS / CSS

:first-child — o primeiro elemento entre os elementos irmãos

A pseudoclasse :first-child corresponde a um elemento que surge em primeiro lugar entre os seus elementos irmãos. Não significa «o primeiro elemento deste tipo»: p:first-child não corresponde a um parágrafo precedido por um título.

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

Sintaxe

:first-child

:first-child é uma pseudoclasse estrutural de CSS, escrita com dois pontos, sem argumentos nem parênteses. O nome first-child sem os dois pontos não é a sintaxe desta pseudoclasse. O seletor p:first-child corresponde a um elemento p apenas quando nenhum elemento irmão o precede; é equivalente a p:nth-child(1).

Para determinar a posição, só contam os elementos. O texto, os espaços em branco e os comentários não alteram essa posição. Não significa o primeiro elemento de um determinado tipo: se um h2 preceder um p, p:first-child não corresponde a esse parágrafo. Utilize p:first-of-type para selecionar o primeiro p entre os elementos irmãos.

Em .group > p:first-child, > exige também que p seja filho direto de um elemento com a classe group. No exemplo, só #selected corresponde; #blocked é precedido por um título e #later por outro parágrafo.

CSS Level 2 descreve esta pseudoclasse como o primeiro filho de outro elemento. Selectors Level 4 define-a como o primeiro elemento entre os seus irmãos, incluindo o próprio elemento, pelo que um elemento sem pai também pode corresponder. Não acrescente à definição moderna o requisito de existir um pai.

Exemplos

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

Resultado

selected

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