Методы выбора

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

В jQuery вер­сии 1.4 и вы­ше вы­бран­ные эле­мен­ты в объ­ек­те jQuery все­гда от­сор­ти­ро­ва­ны в по­ряд­ке их сле­до­ва­ния в до­ку­мен­те, а са­ми мно­же­ст­ва не со­дер­жат дуб­ли­ка­тов.

jQuery().add(sel[, context])
jQuery().add(elts)
jQuery().add(html)

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

jQuery().andSelf()

До­бав­ля­ет в те­ку­щий вы­бор мно­же­ст­во ра­нее вы­бран­ных эле­мен­тов (со сте­ка).

jQuery().children([sel])

Вы­би­ра­ет эле­мен­ты, яв­ляю­щие­ся до­чер­ни­ми, по от­но­ше­нию к вы­бран­ным эле­мен­там.

При вы­зо­ве без ар­гу­мен­тов вы­би­ра­ет все до­чер­ние эле­мен­ты.

При вы­зо­ве с се­лек­то­ром вы­би­ра­ет толь­ко со­от­вет­ст­вую­щие ему до­чер­ние эле­мен­ты.

jQuery().closest(sel[, context])

Вы­би­ра­ет бли­жай­ше­го пред­ка ка­ж­до­го вы­бран­но­го эле­мен­та, со­от­вет­ст­вую­ще­го се­лек­то­ру sel, яв­ляю­ще­го­ся по­том­ком по от­но­ше­нию к эле­мен­ту context.

Ес­ли ар­гу­мент context опу­щен, ис­поль­зу­ет­ся свой­ст­во context объ­ек­та jQuery.

jQuery().contents()

Вы­би­ра­ет все до­чер­ние эле­мен­ты во всех вы­бран­ных эле­мен­тах, вклю­чая тек­сто­вые уз­лы и ком­мен­та­рии.

jQuery().end()

Вы­тал­ки­ва­ет с внут­рен­не­го сте­ка и вос­ста­нав­ли­ва­ет со­стоя­ние вы­бо­ра, пред­ше­ст­во­вав­шее по­след­не­му вы­зо­ву ме­то­да, из­ме­няю­ще­го вы­бор.

jQuery().eq(idx)

Вы­би­ра­ет толь­ко вы­бран­ный эле­мент с ука­зан­ным ин­дек­сом.

В jQuery вер­сии 1.4 от­ри­ца­тель­ные зна­че­ния от­счи­ты­ва­ют­ся с кон­ца мно­же­ст­ва.

jQuery().filter(sel)
jQuery().filter(elts)
jQuery().filter(f(idx):boolean)

Фильт­ру­ет мно­же­ст­во вы­бран­ных эле­мен­тов так, что в ре­зуль­тат вклю­ча­ют­сятоль­ко эле­мен­ты, ко­то­рые со­от­вет­ст­ву­ют се­лек­то­ру sel, или со­дер­жат­ся в объ­ек­те elts, по­доб­ном мас­си­ву, или для ко­то­рых функ­ция-пре­ди­кат f вер­нет true, ко­гда она бу­дет вы­зва­на как ме­тод эле­мен­та.

jQuery().find(sel)

Вы­би­ра­ет всех по­том­ков вы­бран­ных эле­мен­тов, ко­то­рые со­от­вет­ст­ву­ют се­лек­то­ру sel.

jQuery().first()

Вы­би­ра­ет толь­ко пер­вый вы­бран­ный эле­мент.

jQuery().has(sel)
jQuery().has(elt)

Фильт­ру­ет вы­бран­ные эле­мен­ты, вклю­чая в ре­зуль­тат толь­ко эле­мен­ты, ко­то­рые име­ют по­том­ков, со­от­вет­ст­вую­щих се­лек­то­ру sel или яв­ляю­щих­ся пред­ка­ми эле­мен­та elt.

jQuery().last()

Вы­би­ра­ет толь­ко по­след­ний вы­бран­ный эле­мент.

jQuery().next([sel])

Вы­би­ра­ет сле­дую­щий смеж­ный эле­мент для ка­ж­до­го вы­бран­но­го эле­мен­та.

Ес­ли ука­зан ар­гу­мент sel, ис­клю­ча­ет из ре­зуль­та­та эле­мен­ты, не со­от­вет­ст­вую­щие се­лек­то­ру.

jQuery().nextAll([sel])

Вы­би­ра­ет все смеж­ные эле­мен­ты, сле­дую­щие за ка­ж­дым вы­бран­ным эле­мен­том.

Ес­ли ука­зан ар­гу­мент sel, ис­клю­ча­ет из ре­зуль­та­та эле­мен­ты, не со­от­вет­ст­вую­щие се­лек­то­ру.

jQuery().nextUntil(sel)

Вы­би­ра­ет смеж­ные эле­мен­ты, сле­дую­щие за ка­ж­дым вы­бран­ным эле­мен­том, до (но не вклю­чая его) пер­во­го смеж­но­го эле­мен­та, со­от­вет­ст­вую­ще­го се­лек­то­ру sel.

jQuery().not(sel)
jQuery().not(elts)
jQuery().not(f(idx):boolean)

Про­ти­во­по­лож­ный ме­то­ду filter().

Фильт­ру­ет вы­бран­ное мно­же­ст­во, ис­клю­чая эле­мен­ты, ко­то­рые со­от­вет­ст­ву­ют се­лек­то­ру sel, или вклю­че­ны в со­став elts, или для ко­то­рых f вер­нет true.

Ар­гу­мент elts мо­жет быть един­ст­вен­ным эле­мен­том или объ­ек­том, по­доб­ным мас­си­ву, со­дер­жа­щим эле­мен­ты.

Функ­ция f вы­зы­ва­ет­ся как ме­тод для ка­ж­до­го вы­бран­но­го эле­мен­та.

jQuery().offsetParent()

Вы­би­ра­ет бли­жай­ше­го по­зи­цио­ни­руе­мо­го пред­ка для ка­ж­до­го вы­бран­но­го эле­мен­та.

jQuery().parent([sel])

Вы­би­ра­ет ро­ди­те­ля для ка­ж­до­го вы­бран­но­го эле­мен­та.

Ес­ли ука­зан ар­гу­мент sel, ис­клю­ча­ет из ре­зуль­та­та эле­мен­ты, не со­от­вет­ст­вую­щие се­лек­то­ру.

jQuery().parents([sel])

Вы­би­ра­ет пред­ков для ка­ж­до­го вы­бран­но­го эле­мен­та.

Ес­ли ука­зан ар­гу­мент sel, ис­клю­ча­ет из ре­зуль­та­та эле­мен­ты, не со­от­вет­ст­вую­щие се­лек­то­ру.

jQuery().parentsUntil(sel)

Вы­би­ра­ет пред­ков для ка­ж­до­го вы­бран­но­го эле­мен­та до (но не вклю­чая) пер­во­го пред­ка, со­от­вет­ст­вую­ще­го се­лек­то­ру.

jQuery().prev([sel])

Вы­би­ра­ет пред­ше­ст­вую­щий смеж­ный эле­мент для ка­ж­до­го вы­бран­но­го эле­мен­та.

Ес­ли ука­зан ар­гу­мент sel, ис­клю­ча­ет из ре­зуль­та­та эле­мен­ты, не со­от­вет­ст­вую­щие се­лек­то­ру.

jQuery().prevAll([sel])

Вы­би­ра­ет все смеж­ные эле­мен­ты, пред­ше­ст­вую­щие ка­ж­до­му вы­бран­но­му эле­мен­ту.

Ес­ли ука­зан ар­гу­мент sel, ис­клю­ча­ет из ре­зуль­та­та эле­мен­ты, не со­от­вет­ст­вую­щие се­лек­то­ру.

jQuery().prevUntil(sel)

Вы­би­ра­ет смеж­ные эле­мен­ты, пред­ше­ст­вую­щие ка­ж­до­му вы­бран­но­му эле­мен­ту, до (но не вклю­чая его) пер­во­го смеж­но­го эле­мен­та, со­от­вет­ст­вую­ще­го се­лек­то­ру sel.

jQuery().pushStack(elts)

По­ме­ща­ет те­ку­щее со­стоя­ние вы­бо­ра на стек, по­сле че­го оно мо­жет быть вос­ста­нов­ле­но вы­зо­вом ме­то­да end(), и за­тем вы­би­ра­ет эле­мен­ты в мас­си­ве (или в объ­ек­те, по­доб­ном мас­си­ву) elts.

jQuery().siblings([sel])

Вы­би­ра­ет смеж­ные эле­мен­ты для ка­ж­до­го вы­бран­но­го эле­мен­та, ис­клю­чая сам эле­мент.

Ес­ли ука­зан ар­гу­мент sel, ис­клю­ча­ет из ре­зуль­та­та эле­мен­ты, не со­от­вет­ст­вую­щие се­лек­то­ру sel.

jQuery().slice(startidx[, endidx])

Фильт­ру­ет вы­бор, ос­тав­ляя толь­ко эле­мен­ты, ин­дек­сы ко­то­рых боль­ше или рав­ны startidx и мень­ше (но не рав­ны) endidx.

От­ри­ца­тель­ные ин­дек­сы от­счи­ты­ва­ют­ся от кон­ца мно­же­ст­ва вы­бран­ных эле­мен­тов.

Ес­ли ар­гу­мент endidx не ука­зан, ис­поль­зу­ет­ся зна­че­ние свой­ст­ва length.