.slice() | jQuery API 文件

.slice( start [, end ] )傳回： jQuery

說明： 將符合的元素集合縮小到由索引範圍指定的子集合。

新增版本： 1.1.4.slice( start [, end ] )
- start
  
  類型：整數
  
  表示元素開始被選取的 0 為基底的位置的整數。如果是負數，則表示從集合尾端開始的偏移量。
- end
  
  類型：整數
  
  表示元素停止被選取的 0 為基底的位置的整數。如果是負數，則表示從集合尾端開始的偏移量。如果省略，則範圍會持續到集合尾端。

假設有一個 jQuery 物件代表一組 DOM 元素，.slice() 方法會建構一個新的 jQuery 物件，其中包含由 start 和（選擇性）end 參數指定的元素子集合。提供的 start 索引識別集合中某個元素的位置；如果省略 end，則此元素之後的所有元素都會包含在結果中。

考慮一個包含簡單清單的頁面

	
					<ul>
  <li>list item 1</li>
  <li>list item 2</li>
  <li>list item 3</li>
  <li>list item 4</li>
  <li>list item 5</li>
</ul>

我們可以將此方法應用於清單項目

	
					$( "li" ).slice( 2 ).css( "background-color", "red" );

此呼叫的結果是項目 3、4 和 5 的背景為紅色。請注意，提供的索引是從 0 開始，且是指 jQuery 物件中元素的位置，而不是 DOM 樹中的位置。

end 參數允許我們進一步限制選取的範圍。例如

	
					$( "li" ).slice( 2, 4 ).css( "background-color", "red" );

現在只有項目 3 和 4 被選取。索引再次從 0 開始；範圍延伸到指定索引，但不包含該索引。

負索引

jQuery .slice() 方法仿照陣列的 JavaScript .slice() 方法。它模仿的功能之一是能夠將負數傳遞為 start 或 end 參數。如果提供負數，這表示從集合的末尾而不是開頭開始的位置。例如

	
					$( "li" ).slice( -2, -1 ).css( "background-color", "red" );

這次只有清單項目 4 變成紅色，因為它是從末尾開始的兩個 (-2) 和從末尾開始的一個 (-1) 之間範圍中的唯一項目。

範例

根據隨機切片將 div 變成黃色。

	
		
				
				
				
				
					<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>slice demo</title>
  <style>
  div {
    width: 40px;
    height: 40px;
    margin: 10px;
    float: left;
    border: 2px solid blue;
  }
  span {
    color: red;
    font-weight: bold;
  }
  button {
    margin: 5px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<p><button>Turn slice yellow</button>
  <span>Click the button!</span></p>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
 
<script>
function colorEm() {
  var $div = $( "div" );
  var start = Math.floor( Math.random() * $div.length );
  var end = Math.floor( Math.random() * ( $div.length - start ) ) +
    start + 1;
  if ( end === $div.length ) {
    end = undefined;
  }
  $div.css( "background", "" );
  if ( end ) {
    $div.slice( start, end ).css( "background", "yellow" );
  } else {
    $div.slice( start ).css( "background", "yellow" );
  }
  $( "span" ).text( "$( 'div' ).slice( " + start +
    (end ? ", " + end : "") +
    ").css( 'background', 'yellow' );" );
}
 
$( "button" ).on( "click", colorEm );
</script>
 
</body>
</html>

				
			

	

示範

選取所有段落，然後切片選取，僅包含第一個元素。

	
					$( "p" ).slice( 0, 1 ).wrapInner( "<b></b>" );

選取所有段落，然後切片選取，僅包含第一個和第二個元素。

	
					$( "p" ).slice( 0, 2 ).wrapInner( "<b></b>" );

選取所有段落，然後切片選取，僅包含第二個元素。

	
					$( "p" ).slice( 1, 2 ).wrapInner( "<b></b>" );

選取所有段落，然後切片選取，僅包含第二個和第三個元素。

	
					$( "p" ).slice( 1 ).wrapInner( "<b></b>" );

選取所有段落，然後切片選取，僅包含第三個元素。

	
					$( "p" ).slice( -1 ).wrapInner( "<b></b>" );

jQuery API 文件

.slice( start [, end ] )傳回： jQuery

新增版本： 1.1.4.slice( start [, end ] )

負索引

示範