.children()

.children( [selector ] )Возвращает: jQuery

Описание: Получить дочерние элементы каждого элемента в наборе сопоставленных элементов, необязательно отфильтровав их по селектору.

версия добавлена: 1.0.children( [selector ] )
- селектор
  
  Тип: Селектор
  
  Строка, содержащая выражение селектора для сопоставления элементов.

Используя объект jQuery, представляющий набор элементов DOM, метод .children() позволяет нам искать дочерние элементы этих элементов в дереве DOM и создавать новый объект jQuery из соответствующих элементов. Метод .children() отличается от .find() тем, что .children() перемещается только на один уровень вниз по дереву DOM, в то время как .find() может пройти несколько уровней вниз, чтобы выбрать дочерние элементы (внуки и т. д.). Обратите также внимание, что, как и большинство методов jQuery, .children() не возвращает текстовые узлы; чтобы получить все дочерние элементы, включая текстовые и комментарийные узлы, используйте .contents().

Метод .children() необязательно принимает выражение селектора того же типа, что и $() функция. Если селектор указан, элементы будут отфильтрованы с помощью проверки, соответствуют ли они ему.

Рассмотрим страницу с простым вложенным списком:

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

Если мы начинаем со списка уровня 2, мы можем найти его дочерние элементы:

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

Результат этого вызова — красный фон за элементами A, B и C. Поскольку мы не предоставляем выражение селектора, все дочерние элементы являются частью возвращаемого объекта jQuery. Если бы мы его предоставили, были бы включены только соответствующие элементы из этих трёх.

Примеры:

Найти все дочерние элементы нажатого элемента.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>children demo</title>
  <style>
  body {
    font-size: 16px;
    font-weight: bolder;
  }
  div {
    width: 130px;
    height: 82px;
    margin: 10px;
    float: left;
    border: 1px solid blue;
    padding: 4px;
  }
  #container {
    width: auto;
    height: 105px;
    margin: 0;
    float: none;
    border: none;
  }
  .hilite {
    border-color: red;
  }
  #results {
    display: block;
    color: red;
  }
  p, span, em, a, b, button {
    border: 1px solid transparent;
  }
  p {
    margin: 10px;
  }
  span {
    color: blue;
  }
  input {
    width: 100px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<div id="container">
  <div>
    <p>This <span>is the <em>way</em> we</span>
      write <em>the</em> demo,</p>
  </div>
 
  <div>
    <a href="#"><b>w</b>rit<b>e</b></a> the <span>demo,</span> <button>write
    the</button> demo,
  </div>
 
  <div>
    This <span>the way we <em>write</em> the <em>demo</em> so</span>
    <input type="text" value="early"> in
  </div>
 
  <p>
    <span>t</span>he <span>m</span>orning.
    <span id="results">Found <span>0</span> children in <span>TAG</span>.</span>
  </p>
</div>
 
<script>
$( "#container" ).on( "click", function( event ) {
  $( "*" ).removeClass( "hilite" );
  var kids = $( event.target ).children();
  var len = kids.addClass( "hilite" ).length;
 
  $( "#results span" ).first().text( len );
  $( "#results span" ).last().text( event.target.tagName );
 
  event.preventDefault();
} );
</script>
 
</body>
</html>

Демо:

Найти все дочерние элементы каждого div.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>children demo</title>
  <style>
  body {
    font-size: 16px;
    font-weight: bolder;
  }
  span {
    color: blue;
  }
  p {
    margin: 5px 0;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<p>Hello (this is a paragraph)</p>
 
<div><span>Hello Again (this span is a child of the a div)</span></div>
<p>And <span>Again</span> (in another paragraph)</p>
 
<div>And One Last <span>Time</span> (most text directly in a div)</div>
 
<script>
$( "div" ).children().css( "border-bottom", "3px double red" );
</script>
 
</body>
</html>

Демо:

Найти все дочерние элементы с классом "selected" каждого div.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>children demo</title>
  <style>
  body {
    font-size: 16px;
    font-weight: bolder;
  }
  p {
    margin: 5px 0;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<div>
  <span>Hello</span>
  <p class="selected">Hello Again</p>
  <div class="selected">And Again</div>
  <p>And One Last Time</p>
</div>
 
<script>
$( "div" ).children( ".selected" ).css( "color", "blue" );
</script>
 
</body>
</html>

.children( [selector ] )Возвращает: jQuery

версия добавлена: 1.0.children( [selector ] )

Примеры:

Демо:

Демо:

Демо: