Методы вставки и удаления

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

В сиг­на­ту­рах ме­то­дов, при­ве­ден­ных ни­же, ар­гу­мент content мо­жет быть объ­ек­том jQuery, стро­кой с раз­мет­кой HTML или от­дель­ным эле­мен­том до­ку­мен­та, а ар­гу­мент target мо­жет быть объ­ек­том jQuery, от­дель­ным эле­мен­том до­ку­мен­та или стро­кой се­лек­то­ра.

jQuery().after(content)
jQuery().after(f(idx):content)

Встав­ля­ет со­дер­жи­мое content по­сле ка­ж­до­го вы­бран­но­го эле­мен­та или вы­зы­ва­ет f как ме­тод и встав­ля­ет воз­вра­щае­мое зна­че­ние по­сле ка­ж­до­го вы­бран­но­го эле­мен­та.

jQuery().append(content)
jQuery().append(f(idx, html):content)

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

jQuery().appendTo(target)

До­бав­ля­ет вы­бран­ные эле­мен­ты в ко­нец ка­ж­до­го эле­мен­та, оп­ре­де­ляе­мо­го ар­гу­мен­том target, ко­пи­руя их, ес­ли ар­гу­мент target оп­ре­де­ля­ет бо­лее од­но­го эле­мен­та.

jQuery().before(content)
jQuery().before(f(idx):content)

Дей­ст­ву­ет по­доб­но ме­то­ду after(), но встав­ля­ет со­дер­жи­мое content пе­ред вы­бран­ ны­ми эле­мен­та­ми, а не по­сле.

jQuery().clone([data=false])

Соз­да­ет пол­ную ко­пию ка­ж­до­го вы­бран­но­го эле­мен­та и воз­вра­ща­ет но­вый объ­ект jQuery, пред­став­ляю­щий мно­же­ст­во ко­пий эле­мен­тов.

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

jQuery().detach([sel])

Дей­ст­ву­ет по­доб­но ме­то­ду remove(), но не уда­ля­ет дан­ные, свя­зан­ные с от­со­еди­нен­ ны­ми эле­мен­та­ми.

jQuery().empty()

Уда­ля­ет со­дер­жи­мое вы­бран­ных эле­мен­тов.

jQuery().html()
jQuery().html(htmlText)
jQuery().html(f(idx, current):htmlText)

При вы­зо­ве без ар­гу­мен­тов воз­вра­ща­ет со­дер­жи­мое пер­во­го вы­бран­но­го эле­мен­та в ви­де стро­ки с раз­мет­кой HTML.

При вы­зо­ве с од­ним ар­гу­мен­том ус­та­нав­ли­ва­ет со­дер­жи­мое всех вы­бран­ных эле­мен­тов рав­ным стро­ке htmlText или зна­че­нию, воз­вра­щае­мо­му функ­ци­ей f, ко­то­рая вы­зы­ва­ет­ся как ме­тод этих эле­мен­тов.

jQuery().insertAfter(target)

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

insertBefore(target):

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

jQuery().prepend(content)
jQuery().prepend(f(idx, html):content)

Дей­ст­ву­ет по­доб­но ме­то­ду append(), но встав­ля­ет со­дер­жи­мое content в на­ча­ло ка­ж­до­го вы­бран­но­го эле­мен­та, а не в ко­нец.

jQuery().prependTo(target)

Дей­ст­ву­ет по­доб­но ме­то­ду appendTo(), но встав­ля­ет вы­бран­ные эле­мен­ты в на­ча­ло эле­мен­тов, оп­ре­де­ляе­мых ар­гу­мен­том target, а не в ко­нец.

jQuery().remove([sel])

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

Об­ра­ти­те вни­ма­ние, что уда­лен­ные эле­мен­ты ис­клю­ча­ют­ся из со­ста­ва до­ку­мен­та, но по-преж­не­му ос­та­ют­ся чле­на­ми воз­вра­щае­мо­го объ­ек­та jQuery.

jQuery().replaceAll(target)

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

jQuery().replaceWith(content)
jQuery().replaceWith(f(idx, html):content)

За­ме­ща­ет ка­ж­дый вы­бран­ный эле­мент со­дер­жи­мым content или вы­зы­ва­ет функ­цию f как ме­тод для ка­ж­до­го вы­бран­но­го эле­мен­та, пе­ре­да­вая ей ин­декс эле­мен­та и те­ку­щее со­дер­жи­мое в ви­де раз­мет­ки HTML, и за­ме­ща­ет дан­ный эле­мент воз­вра­щае­мым зна­че­ни­ем.

jQuery().text()
jQuery().text(plainText)
jQuery().text(f(idx, current):plainText)

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

При вы­зо­ве с од­ним ар­гу­мен­том ус­та­нав­ли­ва­ет со­дер­жи­мое всех вы­бран­ных эле­мен­тов рав­ным стро­ке plainText или зна­че­нию, воз­вра­щае­мо­му функ­ци­ей f, ко­то­рая вы­зы­ва­ет­ся как ме­тод этих эле­мен­тов.

jQuery().unwrap()

Уда­ля­ет ро­ди­те­ля ка­ж­до­го вы­бран­но­го эле­мен­та, за­ме­щая его вы­бран­ным эле­мен­том и смеж­ны­ми с ним эле­мен­та­ми.

jQuery().wrap(wrapper)
jQuery().wrap(f(idx):wrapper)

Обер­ты­ва­ет ка­ж­дый вы­бран­ный эле­мент, ко­пи­руя оберт­ку, ес­ли вы­бран­ных эле­мен­тов бо­лее од­но­го.

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

Ар­гу­мент wrapper мо­жет быть эле­мен­том, объ­ек­том jQuery, се­лек­то­ром или стро­кой с раз­мет­кой HTML, но он дол­жен оп­ре­де­лять един­ст­вен­ный эле­мент-оберт­ку.

jQuery().wrapAll(wrapper)

Обер­ты­ва­ет все вы­бран­ные эле­мен­ты как груп­пу, встав­ляя оберт­ку wrapper в по­зи­цию пер­во­го вы­бран­но­го эле­мен­та и за­тем ко­пи­руя все вы­бран­ные эле­мен­ты в эле­мент-оберт­ку wrapper.

jQuery().wrapInner(wrapper)
jQuery().wrapInner(f(idx):wrapper)

Дей­ст­ву­ет по­доб­но ме­то­ду wrap(), но обер­ты­ва­ет эле­мен­том wrapper (или воз­вра­щае­мым зна­че­ни­ем функ­ции f) со­дер­жи­мое ка­ж­до­го вы­бран­но­го эле­мен­та, а не са­миэле­мен­ты.