JavaScript怎么获取当前元素的所有兄弟元素

作者:小圆点

时间:2026-11-17

浏览:585

详细讲解在JavaScript中获取当前元素所有兄弟元素的多种方法,包括parentNode.children遍历、递归收集、封装工具函数,并配合完整示例代码和图示说明。

文章目录

在操作 DOM 时,经常需要获取某个元素的所有兄弟元素——比如实现 tab 切换时把其他选项卡的 active 类移除,或者在表格中高亮某一行同时恢复其余行。原生 JavaScript 没有像 jQuery 的 .siblings() 那样的现成方法,但通过 parentNode.children 配合简单过滤就能实现。下面从原理到封装,分步说清楚。

核心思路:从父元素入手

所谓"兄弟元素",就是和当前元素拥有同一个父元素的那些子元素(排除自身)。因此获取步骤可以归纳为两步:先拿到父元素的所有子元素,再把当前元素自己剔除。

parentNode.children 返回的是一个 HTMLCollection,只包含元素节点,不会混入文本节点和注释节点,这正好是大多数场景需要的。相比之下 parentNode.childNodes 会返回所有类型的节点,处理起来多一层判断。

// 最直接的写法
function getSiblings(el) {
  const siblings = [];
  const children = el.parentNode.children;
  for (let i = 0; i < children.length; i++) {
    if (children[i] !== el) {
      siblings.push(children[i]);
    }
  }
  return siblings;
}

调用时传入目标元素即可:

const current = document.querySelector('.item-active');
const sibs = getSiblings(current);
console.log(sibs); // 返回一个数组,包含所有兄弟元素
JavaScript怎么获取当前元素的所有兄弟元素
图1 — 从 parentNode.children 中过滤兄弟元素的过程

用 Array.from 和 filter 简化写法

HTMLCollection 不是真正的数组,没有 filter 方法。不过可以先把它转换成数组,用一行就完成过滤:

function getSiblings(el) {
  return Array.from(el.parentNode.children).filter(child => child !== el);
}

或者用展开运算符:

function getSiblings(el) {
  return [...el.parentNode.children].filter(child => child !== el);
}

两种写法效果完全一样。Array.from 的可读性稍好一点,在旧项目里也更容易通过 polyfill 支持;展开运算符更简洁,现代浏览器和打包环境都没有问题。

只获取前面或后面的兄弟元素

有时候不需要全部兄弟,只需要位于当前元素之前或之后的那些。这时候可以利用 previousElementSibling 和 nextElementSibling 逐个遍历。

// 获取之前的所有兄弟元素
function getPreviousSiblings(el) {
  const result = [];
  let sibling = el.previousElementSibling;
  while (sibling) {
    result.push(sibling);
    sibling = sibling.previousElementSibling;
  }
  return result;
}

// 获取之后的所有兄弟元素
function getNextSiblings(el) {
  const result = [];
  let sibling = el.nextElementSibling;
  while (sibling) {
    result.push(sibling);
    sibling = sibling.nextElementSibling;
  }
  return result;
}

需要注意的是,getPreviousSiblings 返回的数组是从紧邻当前元素的那个开始、向前排列的,顺序和 DOM 中的显示顺序相反。如果需要 DOM 顺序,可以在返回前调用 result.reverse()。

JavaScript怎么获取当前元素的所有兄弟元素
图2 — 沿 previousElementSibling / nextElementSibling 两个方向分别收集兄弟元素

实际场景:Tab 切换中移除兄弟的 active 类

下面用一个完整的例子来演示。假设有一组选项卡按钮,点击其中一个时需要给它加上 active 类,同时移除其他兄弟按钮上的 active。

<ul class="tabs">
  <li class="tab active">选项卡 1</li>
  <li class="tab">选项卡 2</li>
  <li class="tab">选项卡 3</li>
</ul>

<script>
function getSiblings(el) {
  return [...el.parentNode.children].filter(child => child !== el);
}

document.querySelectorAll('.tab').forEach(tab => {
  tab.addEventListener('click', function () {
    // 移除所有兄弟的 active
    getSiblings(this).forEach(sib => sib.classList.remove('active'));
    // 给当前元素加上 active
    this.classList.add('active');
  });
});
</script>

这段代码的关键在于 getSiblings(this) 返回的就是当前被点击元素以外的所有同级 <li>,对它们逐一 classList.remove('active') 即可。相比先用 querySelectorAll('.tab') 遍历全部再排除自己,getSiblings 函数的语义更清晰,尤其在页面上存在多组独立 tab 时不会误操作其他组的元素。

JavaScript怎么获取当前元素的所有兄弟元素
图3 — Tab 切换时获取兄弟并移除 active 的执行步骤

带选择器过滤的增强版

有时只想获取兄弟中满足某个条件的元素。可以给 getSiblings 加一个可选的选择器参数:

function getSiblings(el, selector) {
  const siblings = [...el.parentNode.children].filter(child => child !== el);
  if (!selector) return siblings;
  return siblings.filter(sib => sib.matches(selector));
}

// 用法示例
const el = document.querySelector('.current');
getSiblings(el);            // 所有兄弟
getSiblings(el, '.highlight'); // 只返回带 highlight 类的兄弟
getSiblings(el, 'div');        // 只返回 div 标签的兄弟

Element.matches() 接受一个 CSS 选择器字符串,如果元素本身匹配该选择器就返回 true。这个方法在 IE 9–11 中名为 msMatchesSelector,如果需要兼容,可以加一层判断或用 polyfill。

几个容易忽略的细节

元素没有父节点的情况。如果传入的元素还没有被插入到 DOM 树中(例如刚通过 document.createElement 创建),el.parentNode 是 null,访问 .children 会报错。在工具函数里加一个前置判断是好习惯:

function getSiblings(el, selector) {
  if (!el.parentNode) return [];
  const siblings = [...el.parentNode.children].filter(child => child !== el);
  return selector ? siblings.filter(s => s.matches(selector)) : siblings;
}

children 与 childNodes 的区别。前面提到过,children 只包含元素节点,childNodes 还包含文本节点(空白、换行也算)和注释节点。绝大多数情况下用 children 就对了;只有当你确实需要处理文本或注释节点时才考虑 childNodes,但那已经不算"兄弟元素"的范畴了。

返回值是实时集合还是静态数组。parentNode.children 返回的 HTMLCollection 是实时的——DOM 结构变化后它的内容会自动更新。而经过 Array.from 或展开运算符转换后得到的数组是静态快照。如果你在遍历过程中会修改 DOM(增删兄弟节点),使用静态数组更安全,不会因为集合长度变化而跳过或重复处理元素。

JavaScript怎么获取当前元素的所有兄弟元素
图4 — 各方法适用场景与注意事项总结

小结

获取当前元素的所有兄弟元素,核心就是一个思路:通过父元素拿到所有子元素,再把自己过滤掉。[...el.parentNode.children].filter(child => child !== el) 这一行足以覆盖绑大部分需求。如果只需要某一方向的兄弟,用 previousElementSibling 或 nextElementSibling 循环即可;如果需要按选择器二次筛选,加上 matches() 就行。把这个逻辑封装成一个工具函数放在项目里,以后任何需要操作兄弟元素的地方都可以直接调用。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章