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

CKTIS / CSS

Combinador de irmãos seguintes (~)

O seletor A ~ B corresponde a elementos B que têm o mesmo pai que um elemento A anterior. Os elementos não precisam de estar imediatamente adjacentes.

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

Sintaxe

A ~ B { /* declarations */ }

O combinador ~ (til, U+007E) liga dois seletores compostos. Em A ~ B, as letras representam seletores: um elemento B corresponde se tiver o mesmo pai que algum elemento A anterior na árvore do documento.

Podem existir outros elementos entre A e B. O seletor pode corresponder a vários elementos B seguintes, mas não seleciona o próprio A, irmãos anteriores nem elementos aninhados noutro irmão. O que conta é a ordem na árvore, não a disposição visual.

Ao contrário de A + B, que exige elementos imediatamente adjacentes, A ~ B permite elementos intermédios. No exemplo, h2 ~ p corresponde a first e last; não corresponde a before nem a nested, porque este último tem um pai diferente.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Subsequent siblings</title>
<style>
  h2 ~ p { border-left: 4px solid blue; }
</style>
<section id="demo">
  <p id="before">Before</p>
  <h2>Heading</h2>
  <p id="first">First</p>
  <div><p id="nested">Nested</p></div>
  <p id="last">Last</p>
</section>
<pre id="result"></pre>
<script>
  const matches = document.querySelectorAll('#demo > h2 ~ p');
  document.getElementById('result').textContent =
    Array.from(matches, element => element.id).join(', ');
</script>
</html>

Resultado

first, last

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