.slice( start [, end ] ) Returns: jQuery
Description: Reduce the set of matched elements to a subset specified by a range of indices.
-
version added: 1.1.4.slice( start [, end ] )
-
startType: IntegerAn integer indicating the 0-based position at which the elements begin to be selected. If negative, it indicates an offset from the end of the set.
-
endType: IntegerAn integer indicating the 0-based position at which the elements stop being selected. If negative, it indicates an offset from the end of the set. If omitted, the range continues until the end of the set.
-
Given a jQuery object that represents a set of DOM elements, the .slice()
method constructs a new jQuery object containing a subset of the elements specified by the start
and, optionally, end
argument. The supplied start
index identifies the position of one of the elements in the set; if end
is omitted, all elements after this one will be included in the result.
Consider a page with a simple list on it:
1
2
3
4
5
6
7
|
|
We can apply this method to the set of list items:
1
|
|
The result of this call is a red background for items 3, 4, and 5. Note that the supplied index is zero-based, and refers to the position of elements within the jQuery object, not within the DOM tree.
The end parameter allows us to limit the selected range even further. For example:
1
|
|
Now only items 3 and 4 are selected. The index is once again zero-based; the range extends up to but not including the specified index.
Negative Indices
The jQuery .slice()
method is patterned after the JavaScript .slice() method for arrays. One of the features that it mimics is the ability for negative numbers to be passed as either the start
or end
parameter. If a negative number is provided, this indicates a position starting from the end of the set, rather than the beginning. For example:
1
|
|
This time only list item 4 is turned red, since it is the only item in the range between two from the end (-2
) and one from the end (-1
).
Examples:
Example: Turns divs yellow based on a random slice.
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
|
Example: Selects all paragraphs, then slices the selection to include only the first element.
1
|
|
Example: Selects all paragraphs, then slices the selection to include only the first and second element.
1
|
|
Example: Selects all paragraphs, then slices the selection to include only the second element.
1
|
|
Example: Selects all paragraphs, then slices the selection to include only the second and third element.
1
|
|
Example: Selects all paragraphs, then slices the selection to include only the third element.
1
|
|