Metode parentsUntil() penelusuran jQuery

Contoh

Cari elemen nenek moyang <li class="item-a"> sampai <ul class="level-1">, dan atur latar belakang mereka menjadi merah. Selain itu, cari semua elemen nenek moyang dengan nama kelas "yes" dari <li class="item-2"> sampai <ul class="level-1">, dan atur garis bingkai mereka menjadi biru:

$("li.item-a");.parentsUntil(".level-1");
  .css("background-color", "red");
$("li.item-2");.parentsUntil($("ul.level-1"), ".yes");
  .css("border", "3px solid blue");

Coba sendiri

Definisi dan penggunaan

parentsUntil() mendapatkan elemen nenek moyang dari setiap elemen dalam kumpulan elemen yang disesuaikan saat ini, hingga (tetapi tidak termasuk) elemen yang cocok dengan pemilih, node DOM, atau objek jQuery.

Sintaks 1

.parentsUntil(selector,filter)
Parameter Deskripsi
selector Pilihan. Nilai string yang menentukan di mana pengecekan nenek moyang berhenti.
filter Pilihan. Nilai string yang mengandung ekspresi pemilih untuk mencocokkan elemen.

Sintaks 2

.parentsUntil(element,filter)
Parameter Deskripsi
element Pilihan. Node DOM atau objek jQuery yang menunjukkan di mana pengecekan nenek moyang berhenti.
filter Pilihan. Nilai string yang mengandung ekspresi pemilih untuk mencocokkan elemen.

Penjelasan detil

Jika diberikan objek jQuery yang mewakili kumpulan elemen DOM, metode .parentsUntil() memungkinkan kami untuk mencari elemen nenek moyang dari elemen-elemen ini di pohon DOM, hingga menemukan elemen yang cocok dengan pemilih (parameter yang disampaikan ke metode). Objek jQuery yang dikembalikan mengandung semua elemen nenek moyang, tetapi tidak termasuk elemen yang cocok dengan pemilih yang ditentukan oleh metode .parentsUntil().

Jika tidak cocok atau pemilih tidak diterapkan, semua elemen nenek moyang pilihan akan dipilih; dalam hal ini, elemen yang dipilih oleh metode ini sama dengan .parents() tanpa pemilih.

Untuk jQuery 1.6, DOM node atau objek jQuery, bukan pemilih, dapat digunakan sebagai parameter pertama metode .parentsUntil().

Metode ini menerima ekspresi pilihan pemilih sebagai parameter kedua. Jika parameter ini diterapkan, elemen akan disaring melalui pengecekan apakah elemen cocok dengan pemilih yang disediakan.