jQuery .index() 方法用於搜尋匹配元素在集合中的位置,回傳從 0 起算的索引值。根據傳入參數不同,有四種截然不同的行為模式,掌握這四種模式是處理列表、選單、分頁、輪播等互動元件的關鍵。
// HTML: <ul><li id="foo">foo</li><li id="bar">bar</li><li id="baz">baz</li></ul>
$('#bar').index(); // 回傳 1(在所有 li 同輩中是第 2 個)
用途:判斷目前點擊項目是第幾個,常用於分頁、輪播、Tab 切換。
var domEl = document.getElementById('bar');
$('li').index(domEl); // 回傳 1
用途:事件處理函式中,this 為原生 DOM 時,需轉換索引。
$('li').index($('#bar')); // 回傳 1
$('li').index($('li:gt(0)')); // 回傳 1(取傳入集合第一個元素的位置)
$('#bar').index('li'); // 回傳 1(#bar 在所有 li 中的位置)
$('#nonexist').index('li'); // 回傳 -1(找不到)
注意:此模式下,$(selector).index(subSelector) 實際上是「在 subSelector 匹配的集合中,找 $(selector) 第一個元素的位置」。
<div id="nav">
<a href="#">建站素材</a>
<a href="#">jQuery特效</a>
<a href="#">懶人主機</a>
<a href="#">前端路上</a>
</div>
<script>
$("#nav a").click(function(e) {
e.preventDefault();
// 四種經典寫法,結果皆為相同索引
var index1 = $("#nav a").index(this); // DOM 元素
var index2 = $("#nav a").index($(this)); // jQuery 物件
var index3 = $(this).index(); // 無參數(同輩中位置)
var index4 = $(this).index("a"); // 選擇器
console.log("索引值:", index1); // 0, 1, 2, 3
// 實際應用:顯示對應內容面板
$(".tab-panel").hide().eq(index1).show();
$(this).addClass("active").siblings().removeClass("active");
});
</script>
<div>
<span>A</span>
<span class="target">B</span>
<span>C</span>
</div>
$('.target').index(); // 1(在所有 span 同輩中)
$('span').index('.target'); // 1(在所有 span 中找 .target)
$('.target').index('span'); // 1(.target 在所有 span 中)
// 上述三者結果相同,但語意不同!
.index() 即時計算,動態新增元素會影響結果。若需固定索引,應在建立時儲存 data-index 屬性。
display:none 的元素仍在 DOM 中,.index() 會計入。若需排除隱藏元素,使用 $(selector).filter(':visible').index(target)。
$.fn.trackIndex = function(options) {
var settings = $.extend({
selector: '> *',
onChange: $.noop
}, options);
return this.each(function() {
var $container = $(this);
$container.on('click', settings.selector, function() {
var idx = $container.find(settings.selector).index(this);
settings.onChange.call(this, idx, $container.find(settings.selector).eq(idx));
});
});
};
// 使用方式
$('#nav').trackIndex({
selector: 'a',
onChange: function(idx, $el) {
console.log('切換到第', idx, '項:', $el.text());
}
});
.index() 是 jQuery 中看似簡單但語意豐富的方法。記住核心口訣:
熟練運用這四種模式,能讓列表互動、分頁、輪播、拖曳排序等功能開發事半功倍。