.each()


.each( function )Возвращает: jQuery

Описание: Итерация над объектом JQuery, выполняет функцию для каждого элемента

  • Добавлен в версии: 1.0.each( function )

    • function
      Тип: Function( Integer index, Element element )
      Функция которая будет выполнена для каждого элемента.

Метод .each() специально спроектирован, чтобы сделать циклические операции над DOM-элементами более краткими и менее подверженными ошибкам. При вызове функции перебираются все DOM-элементы включенные в выборку объекта jQuery. Каждый раз при вызове переданной функции, в нее передается индекс текущей итерации (начинается с 0). Что еще более важно, переданная функция вызывается в контексте текущего DOM-элемента, т.е. this будет ссылаться на элемент.

Предположим, у вас есть простой неупорядоченный список на странице:

1
2
3
4
<ul>
<li>foo</li>
<li>bar</li>
</ul>

Вы можете выбрать элементы списка и сделать итерацию по ним:

1
2
3
$( "li" ).each(function( index ) {
console.log( index + ": " + $( this ).text() );
});

Сообщение будет выведено для каждого элемента следующим образом:

0: foo
1: bar

Вы можете остановить цикл вернув в переданной функции значение false.

Важно: большинство методово jQuery которые возвращают объект jQuery также итерируют набор элементов в коллекции элементов объекта jQuery — известны также как неявные итераторы. Когда используется такой метод, то очень часто не нужно явно соверщать итерацию при помощи метода .each():

1
2
3
4
5
6
7
// Метод .each() в данном случае ненужен:
$( "li" ).each(function() {
$( this ).addClass( "foo" );
});
// Вместо этого, Вы должны положиться на неявную итерацию:
$( "li" ).addClass( "bar" );

Примеры использования