向上查找(祖先)
| 方法 | 範圍 | 參數 | 回傳 | 範例 |
| parent() | **直接父層** | 選擇器(可選) | jQuery (0或1個) | `$("span").parent()` |
| parents() | **所有祖先** | 選擇器(可選) | jQuery (0~N,由近至遠) | `$("span").parents("div")` |
| parentsUntil() | 祖先直到指定元素**不含** | 選擇器/元素/jQuery | jQuery | `$("span").parentsUntil(".container")` |
| closest() | **自身含祖先**,第一個匹配 | 選擇器(必填) | jQuery (0或1個) | `$("span").closest("div")` |
💡 **closest vs parents**:`closest` 含自身、停於第一個匹配;`parents` 不含自身、回傳所有匹配。
向下查找(後代)
| 方法 | 範圍 | 回傳 | 範例 |
| children() | **直接子元素** | jQuery | `$("ul").children("li")` |
| find() | **所有後代** | jQuery | `$("ul").find("li")` |
| contents() | 子節點(含文字、註解) | jQuery | `$("iframe").contents()` |
⚠️ `children()` 只找一層;`find()` 遞迴全找。`contents()` 可跨 iframe(同源)。
同層查找(兄弟)
| 方法 | 方向 | 範圍 | 範例 |
| prev() | 前 | 緊鄰 1 個 | `$("li:eq(2)").prev()` |
| prevAll() | 前 | 所有前面 | `$("li:eq(2)").prevAll()` |
| prevUntil() | 前 | 直到指定元素 | `$("li:eq(2)").prevUntil(":first")` |
| next() | 後 | 緊鄰 1 個 | `$("li:eq(1)").next()` |
| nextAll() | 後 | 所有後面 | `$("li:eq(1)").nextAll()` |
| nextUntil() | 後 | 直到指定元素 | `$("li:eq(1)").nextUntil(":last")` |
| siblings() | 雙向 | 所有兄弟(不含自己) | `$("li:eq(1)").siblings()` |
過濾與判斷
// 過濾集合
$("li").filter(".active"); // 符合選擇器
$("li").not(".active"); // 不符合
$("li").first() / .last() / .eq(2); // 位置
$("li").slice(1, 3); // 範圍 [1,3)
// 判斷
$("li").is(".active"); // true/false
$("li").has("ul"); // 含有符合後代的元素
實戰:表格列編輯模式切換
$("table").on("click", ".edit-btn", function () {
const $tr = $(this).closest("tr"); // 向上找列
const $tds = $tr.children("td"); // 直接子 td
$tds.filter(":not(:first)").each(function () {
const txt = $(this).text();
$(this).html(``);
});
$(this).text("儲存").removeClass("edit-btn").addClass("save-btn");
});
效能提示
- `find()` 比完整選擇器 `$("ul li")` 快(已縮小查找範圍)。
- 避免在大型集合上鏈式 `parents().filter()...`,改用 `closest()` 直接定位。
- 事件委派時用 `closest()` 找目標列:`$(e.target).closest("tr")`。
總結速查
// 記憶口訣:
// 親:parent(單) / parents(全) / closest(最近含自己)
// 子:children(直系) / find(子孫) / contents(含文字)
// 兄:prev/prevAll/prevUntil
// 弟:next/nextAll/nextUntil
// 兄妹:siblings(全)