first()


version 1.4以降

解説

要素集合のうち、最初の要素のjQueryオブジェクトを返します。

戻り値

  • jQuery: 要素集合のうち、最初の要素のjQueryオブジェクト

例1:class属性値が"citrus"div要素の、最初の子孫span要素を取得し、背景を橙色にします。

$("div.citrus span").first().css("background-color", "orange");

<div class="citrus"> class属性値が"citrus"div要素 <span>span要素</span>
<div class="lemon"> class属性値が"lemon"div要素 <span>span要素</span> </div>
<span>span要素</span> <span>span要素</span>
<div> div要素 <span>span要素</span> </div>
<span>span要素</span> </div>

eq(0)と同等

first()は、eq(0)のエイリアスです。
利便性のため 1.4 から実装されました。内部でeq(0)が呼び出されています。