ארגומנטים
ערכים מוחזרים
אם ארגומנט נשלח לשיטה
.index(),
ערך מוחזר הוא מספר שלם שמציין מיקום של אלמנט ראשון בתוך אובייקט
jQuery
יחסית לאלמנטים אחים.
אם
.index()
מופעל על אוסף של אלמנטים,
ואלמנט
DOM
או אובייקט
jQuery
נשלח כארגומנט,
.index()
תחזיר מספר שלם המציין מיקום של אלמנט הנשלח, יחסית לאוסף המקורי.
אם מחרוזת של סלקטור נשלחה כארגומנט,
.index()
תחזיר מספר שלם המציין מיקום של אלמנט המקורי יחסית לאלמנטים תואמים על ידי הסלקטור.
אם אלמנט לא נמצא,
.index()
תחזיר
-1
.
פרטים
בנוסף ל-
.get(),
שמקבל אינדקס ומחזיר צומת,
.index()
יכול לקבל צומת
DOM
ולהחזיר אינדקס.
נניח יש לנו רשימה פשוטה לא מסודרת בדף:
<ul> <li id="foo">foo</li> <li id="bar">bar</li> <li id="baz">baz</li> </ul>
אם אנחנו מחפשים אחד משלושה אלמנטים
(
לדוגמה,
באמצעות פונקציה
DOM
או כקונטקס של מטפל אירועים
), .index()
יכול לחפש אלמנט הזה בתוך אלמנטים בהתאמה:
var listItem = document.getElementById('bar');
alert('Index: ' + $('li').index(listItem));
אנחנו נקבל מיקום שמתחיל מאפס של אלמנט ברשימה:
בדומה לזה,
אם אנחנו מחפשים אובייקט
jQuery
שמכיל אחד משלושה אלמנטים ברשימה,
.index()
תחפש עבור אלמנט הזה:
var listItem = $('#bar');
alert('Index: ' + $('li').index(listItem));
שימו לב, אם אוסף של
jQuery
משתמש כארגומנט של שיטה
.index(),
המכיל יותר מאלמנט אחד,
אלמנט ראשון בתוך רשימת האלמנטים ישמש.
var listItems = $('li:gt(0)');
alert('Index: ' + $('li').index(listItems));
אם אנחנו משתמשים במחרוזת כארגומנט של שיטה
.index(),
זה יפורש כי מחרוזת של סלקטור
jQuery.
אלמנט ראשון מתוך אלמנטים בהתאמה, שגם מתאים לסלקטור הזה ימצא.
var listItem = $('#bar');
alert('Index: ' + listItem.index('li'));
אם אנחנו לא נשלח אלמנט,
.index()
תחזיר מיקום של אלמנט ראשון מתוך אלמנטים בהתאמה יחסית לאלמנטים אחים:
alert('Index: ' + $('#bar').index();
דוגמאות
דוגמה 1
בלחיצה מחזיר אינדקס של div בדף.<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<style>
div { background:yellow; margin:5px; }
span { color:red; }
</style>
<script src="http://code.jquery.com/jquery-1.5.js"></script>
<script type="text/javascript" language="javascript">
$(document).ready(function(){
$("div").click(function () {
// this is the dom element clicked
var index = $("div").index(this);
$("span").text("That was div index #" + index);
});
});
</script>
</head>
<body>
<span>Click a div!</span>
<div>First div</div>
<div>Second div</div>
<div>Third div</div>
</body>
</html>
דוגמה 2
מחזיר אינדקס של האלמנט עם ID bar.
var listItem = $('#bar');
$('div').html( 'Index: ' + $('li').index(listItem) );
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<style>div { font-weight: bold; color: #090; }</style>
<script src="http://code.jquery.com/jquery-1.5.js"></script>
<script type="text/javascript" language="javascript">
$(document).ready(function(){
var listItem = $('#bar');
$('div').html( 'Index: ' + $('li').index(listItem) );
});
</script>
</head>
<body>
<ul>
<li id="foo">foo</li>
<li id="bar">bar</li>
<li id="baz">baz</li>
</ul>
<div></div>
</body>
</html>
דוגמה 3
מחזיר אינדקס של אלמנט ראשון באוסף jQuery.<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<style>div { font-weight: bold; color: #090; }</style>
<script src="http://code.jquery.com/jquery-1.5.js"></script>
<script type="text/javascript" language="javascript">
$(document).ready(function(){
var listItems = $('li:gt(0)');
$('div').html( 'Index: ' + $('li').index(listItems) );
});
</script>
</head>
<body>
<ul>
<li id="foo">foo</li>
<li id="bar">bar</li>
<li id="baz">baz</li>
</ul>
<div></div>
</body>
</html>
דוגמה 4
מחזיר אינדקס של אלמנט עם ID bar יחסית לכל אלמנטים 'li'.<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<style>div { font-weight: bold; color: #090; }</style>
<script src="http://code.jquery.com/jquery-1.5.js"></script>
<script type="text/javascript" language="javascript">
$(document).ready(function(){
$('div').html('Index: ' + $('#bar').index('li') );
});
</script>
</head>
<body>
<ul>
<li id="foo">foo</li>
<li id="bar">bar</li>
<li id="baz">baz</li>
</ul>
<div></div>
</body>
</html>
דוגמה 5
מחזיר אינדקס של האלמנט עם ID bar יחסית לאחים שלו.<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<style>div { font-weight: bold; color: #090; }</style>
<script src="http://code.jquery.com/jquery-1.5.js"></script>
<script type="text/javascript" language="javascript">
$(document).ready(function(){
var barIndex = $('#bar').index();
$('div').html( 'Index: ' + barIndex );
});
</script>
</head>
<body>
<ul>
<li id="foo">foo</li>
<li id="bar">bar</li>
<li id="baz">baz</li>
</ul>
<div></div>
</body>
</html>
דוגמה 6
מחזיר -1 , מכיוון שאין כאן אלמנט עם ID foobar.
var foobar = $("li").index( $('#foobar') );
$('div').html('Index: ' + foobar);
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<style>div { font-weight: bold; color: #090; }</style>
<script src="http://code.jquery.com/jquery-1.5.js"></script>
<script type="text/javascript" language="javascript">
$(document).ready(function(){
var foobar = $("li").index( $('#foobar') );
$('div').html('Index: ' + foobar);
});
</script>
</head>
<body>
<ul>
<li id="foo">foo</li>
<li id="bar">bar</li>
<li id="baz">baz</li>
</ul>
<div></div>
</body>
</html>

