jQuery Anotação - método children()

Instância

Encontrar todos os elementos filhos dos divs com classe "selected" e configurá-los como azul:

$("div").children(".selected").css("color", "blue");

Experimente pessoalmente

Definição e uso

O método children() retorna todos os elementos filhos diretos do elemento selecionado.

Sintaxe

.children(selector)
Parâmetro Descrição
selector Valor de string, contendo a expressão de seletor que coincide com os elementos.

Explicação detalhada

Se fornecermos um objeto jQuery que representa uma coleção de elementos DOM, o método .children() nos permite recuperar esses elementos do árvore DOM e construir um novo objeto jQuery com os elementos correspondentes..find() É semelhante ao método .children(), mas o último apenas percorre um único nível da árvore DOM.

Observe que, como a maioria dos métodos jQuery, .children() não retorna nós de texto; se precisar obter todos os nós filhos, incluindo nós de texto e comentários, use .contents().

Este método aceita uma expressão de seletor como parâmetro opcional, do mesmo tipo que passamos para o $(). Se aplicarmos o seletor, testará se o elemento corresponde à expressão, filtrando assim esses elementos.

Pense nessa página com uma lista aninhada básica:

<ul class="level-1">
  <li class="item-i">I</li>
  <li class="item-ii">II
    <ul class="level-2">
      <li class="item-a">A</li>
      <li class="item-b">B
        <ul class="level-3">
          <li class="item-1">1</li>
          <li class="item-2">2</li>
          <li class="item-3">3</li>
        </ul>
      </li>
      <li class="item-c">C</li>
    </ul>
  </li>
  <li class="item-iii">III</li>
</ul>

Experimente pessoalmente

Se começarmos com a lista level-2, podemos encontrar seus elementos filhos:

$('ul.level-2').children().css('background-color', 'red');

O resultado dessa linha de código é que os itens A, B, C recebem o fundo vermelho. Como não aplicamos uma expressão de seletor, o objeto jQuery retornado contém todos os elementos filhos. Se aplicarmos um seletor, apenas incluirá os itens que correspondem.