OpenJS Foundation - openjsf.org · api.jquery.com

.next( [selector ] )Returns: jQuery

Description: Get the immediately following sibling of each element in the set of matched elements. If a selector is provided, it retrieves the next sibling only if it matches that selector.

  • version added: 1.0.next( [selector ] )

    • selector

      A string containing a selector expression to match elements against.

Given a jQuery object that represents a set of DOM elements, the .next() method allows us to search through the immediately following sibling of these elements in the DOM tree and construct a new jQuery object from the matching elements.

The method optionally accepts a selector expression of the same type that we can pass to the $() function. If the immediately following sibling matches the selector, it remains in the newly constructed jQuery object; otherwise, it is excluded.

Consider a page with a simple list on it:

1

2

3

4

5

6

7

<ul>

<li>list item 1</li>

<li>list item 2</li>

<li class="third-item">list item 3</li>

<li>list item 4</li>

<li>list item 5</li>

</ul>

If we begin at the third item, we can find the element which comes just after it:

1

$( "li.third-item" ).next().css( "background-color", "red" );

The result of this call is a red background behind item 4. Since we do not supply a selector expression, this following element is unequivocally included as part of the object. If we had supplied one, the element would be tested for a match before it was included.

Examples:

Example 1

Find the very next sibling of each disabled button and change its text "this button is disabled".

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

<!doctype html>

<html lang="en">

<head>

<meta charset="utf-8">

<title>next demo</title>

<style>

span {

color: blue;

font-weight: bold;

}

button {

width: 100px;

}

</style>

<script src="https://code.jquery.com/jquery-4.0.0.js"></script>

</head>

<body>

<div><button disabled="disabled">First</button> - <span></span></div>

<div><button>Second</button> - <span></span></div>

<div><button disabled="disabled">Third</button> - <span></span></div>

<script>

$( "button[disabled]" ).next().text( "this button is disabled" );

</script>

</body>

</html>

Demo:

Example 2

Find the very next sibling of each paragraph. Keep only the ones with a class "selected".

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

<!doctype html>

<html lang="en">

<head>

<meta charset="utf-8">

<title>next demo</title>

<script src="https://code.jquery.com/jquery-4.0.0.js"></script>

</head>

<body>

<p>Hello</p>

<p class="selected">Hello Again</p>

<div><span>And Again</span></div>

<script>

$( "p" ).next( ".selected" ).css( "background", "yellow" );

</script>

</body>

</html>

Demo:

Read the original on api.jquery.com ↗