addBack()

addBack()はjQueryオブジェクトに以前指定されていたjQueryオブジェクトを追加します。

次のようなHTMLがあったとします。

<ul>
   <li>list item 1</li>
   <li>list item 2</li>
   <li class="third-item">list item 3</li>
   <li>list item 4</li>
   <li>list item 5</li>
</ul>

この場合はitem3を含んだjQueryオブジェクトを返します。

$('li.third-item')

さらに、nextAllメソッドで検索を行うと、item4とitem5を含んだjQueryオブジェクトを返します。

$('li.third-item').nextAll()

ここで、addBack()を適応させることで最初に指定されていたitem3も含んだ形に変更されます。

$('li.third-item').nextAll().addBack()

最終的に上記のコードではitem3、item4、item5を含んだjQueryオブジェクトが返されます。

addBack()はこれまでandSelf()という名称だったメソッドがjQuery 1.8.0で変更されたメソッドです。

登録日 : 2013年01月30日最終更新日 : 2013年1月30日

jQuery リファレンス