Método prevUntil() de jQuery de recorrido
Ejemplo
Buscar los elementos hermanos anteriores a <dt id="term-2"> hasta el <dt> anterior, y establecerlos en rojo. Al mismo tiempo, buscar los elementos hermanos <dd> anteriores a <dt id="term-3"> hasta <dt id="term-1">, y establecerlos en texto azul:
$("#term-2").prevUntil("dt").css("background-color", "red");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("color", "green");
Definición y uso
El método prevUntil() obtiene los elementos hermanos anteriores de cada elemento en la colección de elementos coincidentes, pero no incluye los elementos que coinciden con el selector, el nodo del DOM o el objeto jQuery.
Sintaxis 1
.prevUntil(selector, filter)
| Parámetros | Descripción |
|---|---|
| selector | Opcional. Valor de cadena que contiene la expresión de selector que indica dónde detener la coincidencia de los elementos hermanos anteriores. |
| filter | Opcional. Valor de cadena que contiene la expresión de selector utilizada para coincidir con los elementos. |
Sintaxis 2
.prevUntil(element, filter)
| Parámetros | Descripción |
|---|---|
| element | Opcional. Indica el nodo del DOM o el objeto jQuery en el que debe detenerse la coincidencia de los elementos hermanos anteriores. |
| filter | Opcional. Valor de cadena que contiene la expresión de selector utilizada para coincidir con los elementos. |
Descripción detallada
Si se proporciona un objeto jQuery que representa una colección de elementos del DOM, el método .prevUntil() permite buscar elementos hermanos anteriores en el árbol del DOM hasta que se encuentre un elemento que coincida con el selector (pasado como parámetro al método). El nuevo objeto jQuery devuelto contiene todos los elementos hermanos anteriores, pero no incluye el elemento que coincide con el selector especificado por el método .prevUntil(); el orden de los elementos devueltos es desde el hermano más cercano al más lejano.
Si no hay coincidencia o no se aplica un selector, se seleccionarán todos los elementos hermanos anteriores; en este caso, los elementos seleccionados por este método son los mismos que los seleccionados por .prevAll() sin selector.
Para jQuery 1.6, un nodo del DOM o un objeto jQuery, en lugar de un selector, pueden utilizarse como primer parámetro del método .prevUntil().
Este método acepta una expresión de selector opcional como su segundo parámetro. Si se aplica este parámetro, se filtrarán los elementos mediante la detección de si coinciden con el selector.
