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");
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.