JS怎么获取上一个和下一个兄弟元素

作者:白露

时间:2026-11-20

浏览:254

全面讲解在 JavaScript 中获取上一个和下一个兄弟元素的方法。深入对比 Element 元素属性与 Node 节点属性的本质差异,解析空白文本节点陷阱,并提供安全链式调用、批量遍历同级兄弟元素等实用开发技巧与完整图解。

文章目录
在 JavaScript 中,获取相邻兄弟元素最直接、最标准的方法是使用 previousElementSibling(获取上一个兄弟元素)和 nextElementSibling(获取下一个兄弟元素)。这两个属性专门用来定位同级的真实 HTML 标签元素,会自动跳过代码排版产生的空白符、换行符和注释节点;若当前元素处于边界或没有对应的兄弟元素,则统一返回 null。
JS怎么获取上一个和下一个兄弟元素

图 0:JavaScript 兄弟元素查找核心属性与相对关系总览

一、核心语法与基础使用示例

在日常的前端交互中,我们经常需要实现类似“点击当前按钮时高亮上一个按钮”或“展开某个标题时控制紧随其后的内容容器”这类需求。在 DOM 元素对象上,浏览器提供了两个原生只读属性:

  • element.previousElementSibling:返回当前元素紧邻的前一个HTML 元素。若不存在,返回 null。
  • element.nextElementSibling:返回当前元素紧邻的后一个HTML 元素。若不存在,返回 null。

我们来看一个典型的 HTML 列表结构和对应的操作脚本:

<!-- 示例 HTML 结构 -->
<ul id="menu">
  <li id="item-1">首页</li>
  <li id="item-2" class="active">产品中心</li>
  <li id="item-3">关于我们</li>
</ul>

<script>
  const current = document.querySelector('.active');

  // 1. 获取上一个兄弟元素
  const prevElem = current.previousElementSibling;
  console.log(prevElem); // 输出: <li id="item-1">首页</li>

  // 2. 获取下一个兄弟元素
  const nextElem = current.nextElementSibling;
  console.log(nextElem); // 输出: <li id="item-3">关于我们</li>
</script>

在这段代码中,无论你在 <li> 标签之间打了多少次回车、空格,甚至插入了 HTML 注释,previousElementSibling 与 nextElementSibling 都能稳健地返回相邻的 <li> 元素对象。

二、深入原理:为什么不要使用 previousSibling 与 nextSibling?

初学者在学习 DOM API 时,常容易将带有 Element 单词的属性与不带 Element 的属性混淆(例如 previousSibling 和 nextSibling)。理解这两组属性的区别是避免低级 Bug 的关键。

在 W3C DOM 规范中,页面上的所有内容都是节点(Node),包括元素标签、纯文本、HTML 注释、属性等。而元素(Element)只是节点中的一种具体类型(其 nodeType === 1)。

JS怎么获取上一个和下一个兄弟元素

图 1:DOM 节点树与元素树的区别及兄弟查找命中机制对比

为了让排版美观,我们在编写 HTML 代码时通常会进行缩进和换行。在浏览器解析 DOM 时,标签之间的换行符与空格都会被生成为一个独立的 #text 文本节点。此时若调用 previousSibling:

const current = document.getElementById('item-2');

// 错误做法:使用 Node 级属性
const wrongPrev = current.previousSibling;
console.log(wrongPrev); 
// 极其可能输出: #text 文本节点(内容为一个回车和空格)

// 此时如果直接读取样式或类名:
wrongPrev.classList.add('highlight'); 
// 报错: TypeError: Cannot read properties of undefined (reading 'add')

由此可见,previousSibling 和 nextSibling 获取的是“上一个/下一个节点”,绝大部分情况下拿到的都是无意义的空白文本节点,只有在极其特殊的富文本编辑器内部计算光标偏移量时才有使用价值。在 99% 的常规开发中,必须使用 previousElementSibling 和 nextElementSibling。

三、标准操作流程与空值防御指南

在实际工程代码中,仅仅知道属性名还不够,还必须做好边界条件的防护。因为任何位于同级第一项的元素,其前面都没有兄弟元素;位于同级最后一项的元素,其后面也没有兄弟元素。

JS怎么获取上一个和下一个兄弟元素

图 2:兄弟元素获取与安全调用的完整操作流程

当不存在相邻元素时,属性会返回 null。如果直接对 null 调用方法(例如 sibling.classList),浏览器会直接抛出著名的 TypeError: Cannot read properties of null 异常导致脚本中断。推荐采用以下两套防守方案:

方案 1:使用标准条件判断(传统且清晰)

const currentItem = document.querySelector('.item');
const nextItem = currentItem.nextElementSibling;

if (nextItem !== null) {
  nextItem.classList.add('focused');
  nextItem.focus();
} else {
  console.log('当前已经是最后一个元素,无下一个兄弟');
}

方案 2:使用现代可选链操作符 ?.(简洁高效)

// 使用 ?. 操作符,若无下一个兄弟元素则静默求值为 undefined,不会报错崩毁
currentItem.nextElementSibling?.classList.add('focused');
实战场景提示:手风琴面板(Accordion)切换

在手风琴效果中,点击标题 <h3 class="title"> 时需要展开紧邻的内容块 <div class="content">。此时通过 e.currentTarget.nextElementSibling 可以精准取得下方的内容面板,完全解耦具体的 ID 绑定,使组件代码具备通用复用能力。

四、Element 兄弟属性与 Node 兄弟属性全面对比

为了加深理解并便于技术选型,我们将两组 API 的核心特征整理成对比矩阵:

JS怎么获取上一个和下一个兄弟元素

图 3:Element 元素级与 Node 节点级兄弟 API 特性对比矩阵

对比维度 Element 兄弟属性(推荐) Node 兄弟属性(慎用)
前向属性 previousElementSibling previousSibling
后向属性 nextElementSibling nextSibling
返回值类型 Element 对象或 null Node 节点(包含文本、注释)或 null
对空白文本的处理 自动跳过所有空白与换行 会将换行/空格作为 #text 节点返回
浏览器兼容性 所有主流现代浏览器(IE9+)完全支持 所有浏览器完全支持(最底层接口)
工程使用建议 业务界面交互的标准首选方案 仅在底层文本分析或富文本光标定位时使用

五、进阶场景:查找全部兄弟与条件匹配

除了获取紧邻的“一个”兄弟元素,业务中还常常会衍生出两类高频需求:获取当前元素的所有同级兄弟,以及向前/向后找到符合某个 CSS 类名的兄弟。

1. 获取当前元素的所有同级兄弟元素(排他性高亮)

原生 DOM 没有提供形如 siblings() 的单体 API,但我们可以通过其父级元素的 children 集合,配合数组过滤轻松实现:

function getAllSiblings(elem) {
  if (!elem.parentElement) return [];
  // 1. 将父级的 HTMLCollection 转为真实数组
  // 2. filter 过滤掉自身,即可得到全部同级兄弟
  return Array.from(elem.parentElement.children).filter(child => child !== elem);
}

// 使用示例:点击激活当前项,其余所有兄弟元素取消激活
const activeItem = document.querySelector('.active');
getAllSiblings(activeItem).forEach(sibling => {
  sibling.classList.remove('active');
});

2. 向后连续查找符合特定选择器的兄弟元素

有时候我们想找的不是“紧邻的第一个”,而是“紧随其后的某个特定 class 元素”。这时可以利用 while 循环结合 Element.matches() 进行定向探查:

function findNextSiblingBySelector(elem, selector) {
  let current = elem.nextElementSibling;
  while (current) {
    if (current.matches(selector)) {
      return current; // 命中目标,返回该元素
    }
    current = current.nextElementSibling; // 步进到下一个兄弟元素
  }
  return null; // 未找到匹配元素
}

六、全文总结与速查决策

回顾本文的核心结论与工程建议:

  1. 牢记属性名:始终优先选用 previousElementSibling 和 nextElementSibling,从根源上避开空白文本节点带来的未定义错误。
  2. 防御空指针:处于列表端点的元素必将返回 null,操作前务必进行非空验证,推荐在现代工程中使用可选链 ?. 编写稳健代码。
  3. 灵活组合:结合父元素的 children 属性或利用 while 迭代,可以非常干净地衍生出全部兄弟获取、指定选择器兄弟查找等复杂业务逻辑。
JS怎么获取上一个和下一个兄弟元素

图 4:JavaScript 兄弟元素查找模式全景与速查决策图

实用工具推荐

电子包浆

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

使用 ›
图片压缩

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

使用 ›
相关文章