jQuery Navegação - método prevUntil()
Exemplo
Selecione todos os parágrafos e reduza o conteúdo selecionado para incluir apenas os primeiros e segundos parágrafos:
$("p").slice(0, 2).wrapInner(");
Definição e uso
slice() reduz a coleção de elementos correspondentes para um subconjunto dentro do intervalo de índices especificados.
Sintaxe
.slice(selector,end)
Parâmetros | Descrição |
---|---|
selector |
Inteiro com base em 0, que indica a posição do elemento de início da seleção. Se for negativo, indica a quantidade de deslocamento a partir do final da coleção. |
end |
Inteiro com base em 0, que indica a posição do elemento de término da seleção. Se for negativo, indica a quantidade de deslocamento a partir do final da coleção. Se omitido, o intervalo de seleção terminará no final da coleção. |
Explicação detalhada
Se fornecido um objeto jQuery que representa uma coleção de elementos DOM, o método .slice() constrói um novo objeto jQuery com um subconjunto de elementos correspondentes. A posição do elemento na coleção de índices aplicados; se o parâmetro end for omitido, todos os elementos após o índice serão incluídos no resultado.
Pense nessa página com uma lista simples:
<ul> <li>item da lista 1</li> <li>item da lista 2</li> <li>item da lista 3</li> <li>item da lista 4</li> <li>item da lista 5</li> </ul>
Podemos aplicar este método à coleção de itens da lista:
$('li').slice(2).css('background-color', 'red');
O resultado da chamada desta vez é que o fundo dos itens 3, 4 e 5 é definido como vermelho. Note que o parâmetro index aplicado é baseado em zero e faz referência à posição dos elementos no objeto jQuery, não na árvore DOM.
O parâmetro end permite que limitemos ainda mais o intervalo de seleção. Por exemplo:
$('li').slice(2, 4).css('background-color', 'red');
Agora, apenas os itens 3 e 4 serão selecionados. Novamente, o índice é baseado em zero; o intervalo se estenderá até (mas não incluirá) o índice especificado.
Exponenciais negativas
O método .slice() do jQuery imita o método .slice() do objeto de array JavaScript. Uma das características que ele imita é a capacidade de passar números negativos para os parâmetros start ou end. Se fornecidos números negativos, eles indicam uma posição a partir do final da coleção, não do início. Por exemplo:
$('li').slice(-2, -1).css('background-color', 'red');
Nesta vez, apenas o item da lista 4 ficará vermelho, pois este projeto é o único dentro do intervalo entre o fim (-2) e o fim (-1) contados.