jQuery リファレンス：:eq( )

索引

Core：コアとなる仕組み

Selectors：セレクタ

└ 目次
基礎
├ *（すべて）
├ element（html要素）
├ #id名（ID属性）
├ .class名（clas属性）
├ 複数のセレクタ(and)
└ 複数のセレクタ(or)
階層関連
├ 先祖子孫
├ >（子要素）
├ +（直近の後要素）
└ ~（後要素）
属性
├ [属性名]
├ [属性名='値']
├ [属性名!='値']
├ [属性名^='値']
├ [属性名$='値']
├ [属性名*='値']
├ [属性名-='値']
├ [属性名|='値']
└ 複数の属性
基本フィルタ
├ :root
├ :header
├ :lang()
├ :target
├ :animated
├ :first
├ :last
├ :even
├ :odd
├ :eq()
├ :gt()
├ :lt()
└ :not()
子要素フィルタ
├ :first-child
├ :first-of-type
├ :last-child
├ :last-of-type
├ :only-child
├ :only-of-type
├ :nth-child()
├ :nth-of-type()
├ :nth-last-child()
└ :nth-last-of-type()
可視性フィルタ
├ :hidden
└ :visible
コンテンツフィルタ
├ :contains()
├ :has()
├ :empty
└ :parent
フォーム
├ :checked
├ :selected
├ :disabled
├ :enabled
├ :focus
├ :button
├ :checkbox
├ :file
├ :image
├ :input
├ :password
├ :radio
├ :reset
├ :submit
└ :text

Attributes：属性

Traversing：対象の変更

└ 目次
ツリー（階層）
├ .siblings()
├ .next()
├ .nextAll()
├ .nextUntil()
├ .prev()
├ .prevAll()
├ .prevUntil()
├ .children()
├ .find()
├ .parent()
├ .parents()
├ .parentsUntil()
├ .offsetParent()
└ .closest()
フィルタリング
├ .eq()
├ .slice()
├ .first()
├ .last()
├ .filter()
├ .has()
├ .not()
├ .is()
└ .map()
その他
├ .add()
├ .andSelf()
├ .addBack()
├ .end()
├ .contents()
└ .each()

Manipulation：操作

├ 目次
要素の挿入
├ .after()
├ .before()
├ .append()
├ .prepend()
├ .insertAfter()
├ .insertBefore()
├ .appendTo()
└ .prependTo()
要素の削除
├ .empty()
└ .remove()
├ .detach()
要素を囲む
├ .wrap()
├ .wrapAll()
└ .wrapInner()
├ .unwrap()
その他
├ .text()
├ .html()
├ .clone()
├ .replaceAll()
└ .replaceWith()
他ページ参照
├ .toggleClass()
├ .hasClass()
├ .addClass()
├ .removeClass()
├ .attr()
├ .removeAttr()
├ .prop()
├ .removeProp()
├ .val()
├ .css()
├ .offset()
├ .position()
├ .height()
├ .innerHeight()
├ .outerHeight()
├ .width()
├ .innerWidth()
├ .outerWidth()
├ .scrollLeft()
└ .scrollTop()

CSS：スタイルシート

Events：イベント

└ 目次
マウスイベント
├ .click()
├ .dblclick()
├ .mousedown()
├ .mouseup()
├ .mouseover()
├ .mouseout()
├ .mouseenter()
├ .mouseleave()
├ .mousemove()
├ .hover()
└ .toggle()
キーイベント
├ .keydown()
├ .keypress()
├ .keyup()
├ .focusin()
└ .focusout()
フォームイベント
├ .focus()
├ .blur()
├ .change()
├ .select()
└ .submit()
ブラウザイベント
├ .resize()
├ .scroll()
└ .error()
ロードイベント
├ .load()
├ .unload()
└ .ready()
イベントハンドラアタッチ
├ .bind()
├ .unbind()
├ .live()
├ .die()
├ .delegate()
├ .undelegate()
├ .on()
├ .off()
├ .one()
├ .triggerHandler()
└ .trigger()
イベントオブジェクト
├ jQuery.Event
├ eo.type
├ eo.data
├ eo.pageX
├ eo.pageY
├ eo.timeStamp
├ eo.which
├ eo.result
├ eo.namespace
├ eo.target
├ eo.currentTarget
├ eo.delegateTarget
├ eo.relatedTarget
├ eo.stopPropagation()
├ eo.stopImmediateP...
├ eo.preventDefault()
├ eo.isPropagationSt...
├ eo.isImmediatePre...
└ eo.isDefaultPreven...

Effects：演出効果

└ 目次
基礎
├ .hide()
├ .show()
└ .toggle()
スライド
├ .slideUp()
├ .slideDown()
└ .slideToggle()
フェード
├ .fadeOut()
├ .fadeIn()
├ .fadeTo()
└ .fadeToggle()
カスタム
├ .animate(prop)
├ .animate(prop,opt...
├ .stop()
├ .delay()
├ .queue()
├ .dequeue()
├ .clearQueue()
├ .finish()
├ jQuery.queue()
├ jQuery.dequeue()
├ jQuery.fx.interval
└ jQuery.fx.off

Ajax：xml等との連携

└ 目次
簡易メソッド
├ .load()
├ jQuery.get()
├ jQuery.getJSON()
├ jQuery.getScript()
└ jQuery.post()
グローバルイベントハンドラ
├ .ajaxComplete()
├ .ajaxSuccess()
├ .ajaxError()
├ .ajaxSend()
├ .ajaxStart()
└ .ajaxStop()
低レベル・インターフェイス
├ jQuery.ajax()
├ jQuery.ajaxSetup()
└ jQuery.ajaxPrefilt...
お助け機能
├ jQuery.param()
├ .serialize()
└ .serializeArray()

Utilities：ユーティリティ

Data：データ

Miscellaneous：諸々

├ 目次
├ .index()
├ .get()
├ .toArray()
├ .length
└ .size()

Deferred：処理管理

└ 目次
deferredの作成
└ jQuery.deferred()
promiseの作成
├ jQuery.when()
├ .promise()
└ deferred.promise()
コールバックの設定
├ deferred.done()
├ deferred.fail()
├ deferred.always()
├ deferred.progress()
├ deferred.then()
└ deferred.pipe()
状態の取得
├ deferred.state()
├ deferred.isReso...
└ deferred.isReje...
状態の変更
├ deferred.resolve()
├ deferred.resolveW...
├ deferred.reject()
├ deferred.rejectW...
├ deferred.notify()
└ deferred.notifyW...

Callbacks：コールバック

Internals：内部処理

:eq( )指定したインデックス番号の要素を選択

構文

指定したインデックス番号の要素を選択: $(":eq(インデックス番号)")ver1.0〜
$(":eq(負のインデックス番号)")ver1.8〜
※:（コロン）を忘れないように注意しましょう
※インデックス番号は0から始まることに注意。

機能

:（コロン）に続けてeqを設定し、引数としてインデックス番号を指定すると指定したインデックス番号の要素を選択します。このときインデックス番号は0から始まることに注意してください。

ver1.8からは負のインデックス番号を指定することで、最後の要素から数えた要素を選択できるようになりました。この場合インデックス番号は-1から始まります。

解説

指定したインデックス番号の要素を選択します

サンプル（eq/01.html）を開いてbody内にdiv要素が6つあることを確認してください。

<div>0番目</div>
<div>1番目</div>
<div>2番目</div>
<div>3番目</div>
<div>4番目</div>
<div>5番目</div>

jQueryには以下の様に記述され、複数のセレクタ(and)を利用してdiv要素と組みあわせました。そのためbuttonをクリックするとdiv要素のうち0番目の要素を選択します。選択した要素はcssメソッドを利用して背景色を緑にします。

$("button").click(function(){
	$("div:eq(0)").css("background-color","#9f9");
});

結果として、buttonをクリックすると一番上のdiv要素の背景色が緑になります。

ページ全体を通してのインデックス番号です

インデックス番号はページを通して連番になっていることの注意してください。サンプル（eq/02.html）を開いてbody内にol要素とul要素の２つのリストがあることを確認して下さい。各リストにはli要素が5つづつあります。

jQueryは以下の様に記述され、buttonをクリックするとli要素のうち8番目の要素を選択します。選択した要素はcssメソッドを利用して背景色をピンクにします。

$("button").click(function(){
	$("li:eq(8)").css("border","3px solid red");
});

ul要素とol要素は異なるリスト要素ですが、li要素は共通のためul要素/ol要素を通して連続したインデックス番号が設定されます。その結果、buttonをクリックするとul要素の下から2番目のli要素が選択されます。

他のセレクタと組みあわせる

もしul要素やol要素ごとにli要素を選択したい場合は>（子要素）を利用します。サンプル（eq/03.html）を開いてbody内の構成がeq/02.htmlと同じことを確認してください。jQueryは以下の様に記述され、セレクタに >（子要素）が追加されてul要素内の1番目のliを選択するようにしました。

$("button").click(function(){
	$("ul>li:eq(1)").css("background-color","#FCC");
});

その結果、buttonをクリックするとul要素内で1番目のli要素が選択されます。

サンプルeq/03.htmlではul要素内にli要素しかないので、li要素の記述は省略しても同じです。サンプル（eq/03b.html）を開いてjQueryが以下の様に変更されていることを確認して下さい。しかし選択される要素はサンプルeq/03.htmlと同じになります。

$("button").click(function(){
	$("ul>:eq(1)").css("background-color","#FCC");
});

負のインデックス番号も利用できます

Traversingのeq()では以前から負のインデックス番号を利用できていたのですが、セレクタのeq()もv1.8から負のインデックス番号が利用できるようになりました。

サンプル（eq/04.html）を開いてbody内の構成がeq/01.htmlと同じ事を確認してください。jQueryは以下の様にセレクタeqの引数に-1が設定されています。結果としてbuttonをクリックすると最後から1番目のdiv要素が選択されます。

$("button").click(function(){
	$("div:eq(-1)").css("background-color","#9f9");
});

最後から2番目を選択したい場合はサンプル（eq/04b.html）のように引数に-2を設定します。

$("button").click(function(){
	$("div:eq(-2)").css("background-color","#9f9");
});

メモ

eq()を利用する対象が、すでにjQueryオブジェクトになっている場合はTraversingのeq()を利用しても良いでしょう。

次のページ： :gt()

:eq( )指定したインデックス番号の要素を選択

構文

機能

解説

指定したインデックス番号の要素を選択します

ページ全体を通してのインデックス番号です

他のセレクタと組みあわせる

負のインデックス番号も利用できます

関連項目

メモ