Metode parentsUntil() Perjalanan jQuery

Panduan Perjalanan jQuery

Contoh

Cari elemen ancestor untuk <li class="item-a"> sampai <ul class="level-1">, dan atur latar belakang mereka menjadi merah. Selain itu, cari semua elemen ancestor untuk <li class="item-2"> yang memiliki kelas "yes", 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 ancestor untuk setiap elemen dalam koleksi yang cocok saat ini, hingga (tetapi tidak termasuk) elemen yang dicocokkan dengan selector, node DOM, atau objek jQuery.

Grammar 1

.parentsUntil(selector,filter)
Parameter Keterangan
selector Pilihan. Nilai string, menentukan di mana pemilihan ancestor dihentikan.
filter Pilihan. Nilai string, berisi ekspresi selector yang digunakan untuk mencocokkan elemen.

Grammar 2

.parentsUntil(element,filter)
Parameter Keterangan
element Pilihan. Node DOM atau objek jQuery, menunjukkan di mana pemilihan ancestor dihentikan.
filter Pilihan. Nilai string, berisi ekspresi selector yang digunakan untuk mencocokkan elemen.

Keterangan detil

Jika diberikan objek jQuery yang mewakili koleksi elemen DOM, metode .parentsUntil() memungkinkan kami untuk mencari elemen ancestor dari elemen-elemen ini di pohon DOM, hingga menemukan elemen yang cocok dengan selector (dipasangkan ke parameter metode). Objek jQuery yang dikembalikan mengandung semua elemen ancestor, tetapi tidak termasuk elemen yang dicocokkan oleh selector yang ditentukan oleh metode .parentsUntil().

Jika tidak cocok atau selector tidak diterapkan, semua elemen ancestor akan dipilih; dalam kasus ini, elemen yang dipilih oleh metode ini sama dengan .parents() tanpa pemberian selector.

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

Metode ini menerima ekspresi pilihan selector sebagai parameter kedua. Jika parameter ini diterapkan, elemen akan disaring melalui deteksi apakah elemen cocok dengan selector itu.

Panduan Perjalanan jQuery