Método parentsUntil() de jQuery para el bucle
Ejemplo
Buscar elementos ancestors del <li class="item-a"> hasta <ul class="level-1"> y establecerles un fondo rojo. Al mismo tiempo, encontrar todos los elementos ancestors del <li class="item-2"> con el nombre de clase "yes" hasta <ul class="level-1"> y establecerles un borde azul:
$("li.item-a");.parentsUntil(".level-1"); .css("background-color", "red"); $("li.item-2");.parentsUntil($("ul.level-1"), ".yes"); .css("border", "3px solid blue");
Definición y uso
El método parentsUntil() obtiene elementos ancestors de cada elemento en la colección de elementos coincidentes actual, hasta (pero no incluyendo) el elemento que coincide con el selector, nodo DOM o objeto jQuery.
Sintaxis 1
.parentsUntil(selector,filter)
Parámetros | Descripción |
---|---|
selector | Opcional. Valor de cadena que especifica dónde detener la coincidencia de elementos ancestors. |
filter | Opcional. Valor de cadena que contiene la expresión de selector utilizada para coincidir con los elementos. |
Sintaxis 2
.parentsUntil(element,filter)
Parámetros | Descripción |
---|---|
element | Opcional. Nodo DOM o objeto jQuery que indica dónde detener la coincidencia de elementos ancestors. |
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 DOM, el método .parentsUntil() permite buscar elementos ancestors de estos elementos en el árbol DOM hasta que se encuentre un elemento que coincida con el selector (pasado como parámetro al método). El objeto jQuery devuelto contiene todos los elementos ancestors, pero no incluye el elemento que coincide con el selector especificado por el método .parentsUntil().
Si no hay coincidencia o no se aplica un selector, se seleccionarán todos los elementos ancestors; en este caso, los elementos seleccionados por este método son los mismos que los seleccionados por .parents() sin selector.
Para jQuery 1.6, un nodo DOM o un objeto jQuery, en lugar de un selector, pueden utilizarse como primer parámetro del método .parentsUntil().
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.