萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery index() 方法完全指南:獲取元素索引的四種用法與實戰範例

index() 方法總覽

jQuery .index() 方法用於搜尋匹配元素在集合中的位置,回傳從 0 起算的索引值。根據傳入參數不同,有四種截然不同的行為模式,掌握這四種模式是處理列表、選單、分頁、輪播等互動元件的關鍵。

四種參數模式詳細解析

1. 無參數:獲取元素在同輩中的位置

// HTML: <ul><li id="foo">foo</li><li id="bar">bar</li><li id="baz">baz</li></ul>
$('#bar').index();  // 回傳 1(在所有 li 同輩中是第 2 個)

用途:判斷目前點擊項目是第幾個,常用於分頁、輪播、Tab 切換。

2. 傳入 DOM 元素:獲取該元素在 jQuery 集合中的索引

var domEl = document.getElementById('bar');
$('li').index(domEl);  // 回傳 1

用途:事件處理函式中,this 為原生 DOM 時,需轉換索引。

3. 傳入 jQuery 物件:獲取該物件第一個元素在原集合中的索引

$('li').index($('#bar'));           // 回傳 1
$('li').index($('li:gt(0)'));       // 回傳 1(取傳入集合第一個元素的位置)

4. 傳入選擇器字串:獲取原元素在選擇器匹配集合中的位置

$('#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>

常見錯誤與避坑指南

錯誤 1:混淆「集合索引」與「同輩索引」

<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 中)
// 上述三者結果相同,但語意不同!

錯誤 2:動態新增元素後索引未更新

.index() 即時計算,動態新增元素會影響結果。若需固定索引,應在建立時儲存 data-index 屬性。

錯誤 3:隱藏元素仍計入索引

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 中看似簡單但語意豐富的方法。記住核心口訣:

  • 無參數 → 我在同輩中第幾?
  • 傳 DOM/jQuery → 你在我集合中第幾?
  • 傳選擇器 → 我在你集合中第幾?
  • 找不到 → 回傳 -1

熟練運用這四種模式,能讓列表互動、分頁、輪播、拖曳排序等功能開發事半功倍。

copyright © 萬盛學電腦網 all rights reserved