如何使用 jQuery 通过链接控制手风琴(Accordion)的展开与收起

碧海醫心

碧海醫心

2026-08-03

503人浏览

原创

如何使用 jQuery 通过链接控制手风琴(Accordion)的展开与收起

本文详解如何用 jQuery 实现点击外部链接触发手风琴面板的准确展开/收起,重点解决因混淆 .attr() 与 .prop() 导致的状态不同步问题,并提供可复用的健壮代码方案。

本文详解如何用 jquery 实现点击外部链接触发手风琴面板的准确展开/收起,重点解决因混淆 `.attr()` 与 `.prop()` 导致的状态不同步问题,并提供可复用的健壮代码方案。

在构建交互式页面时,常需通过独立按钮或链接(如“Read more”)控制手风琴组件的开关状态。但若直接操作 DOM 属性而不区分语义,极易引发状态错乱——典型表现是:首次点击链接可展开,手动点击标题可收起;但再次点击同一链接时,面板却无法关闭,表面“失效”。根本原因在于: 的 checked 状态属于 DOM 属性(property),而非静态 HTML 属性(attribute)

✅ 正确做法:始终使用 .prop() 操作表单状态

jQuery 中:

  • .attr('checked', true) 修改的是 HTML 标签中 checked 属性的字符串值(如 ),不反映真实交互状态
  • .prop('checked', true) 直接设置 DOM 元素的 checked 布尔属性,同步更新浏览器内部状态和视觉反馈,确保 CSS 选择器 :checked 生效。

因此,修复关键仅需两处调整:

  1. 为链接添加 data-id,实现动态目标绑定

    <a href="#" data-id="1" class="button">Read more title 1</a>
    <a href="#" data-id="2" class="button">Read more title 2</a>
  2. 使用 .prop() 设置 checkbox 状态,并移除冗余内联样式

    jQuery 1.12.4
    jQuery 1.12.4

    jQuery 1.12.4是jQuery 1.x系列的最后一个正式稳定版本,由jQuery团队于2016年发布。该版本主要面向需要兼容旧版浏览器环境的网站和Web应用,尤其适用于仍需支持Internet Explorer 6、Internet Explorer 7、Internet Explorer 8等老旧浏览器的项目。

    下载
    $("a.button").on("click", function(e) {
      e.preventDefault();
      const targetId = $(this).data('id');
      // 清除所有已选状态(可选:实现单选模式)
      $(".accordion-wrapper input").prop('checked', false);
      // 设置目标项为选中
      $(`.accordion-wrapper input[id="${targetId}"]`).prop('checked', true);
    });

⚠️ 注意:原代码中 $(".accordion-wrapper div:nth-child(1) article").attr('style', 'max-height:inherit;') 是危险写法——它绕过 CSS 规则,强行注入内联样式,破坏 :checked ~ article 的声明式控制,且无法被后续 .prop() 触发的 CSS 过渡覆盖。应完全交由 CSS 控制显隐逻辑,JS 仅负责状态切换。

完整可运行示例



  <style>
    .accordion-wrapper { margin: 2rem 0; }
    .accordion-wrapper > div { margin: 1rem 0; }
    .accordion-wrapper article {
      background: rgba(255, 255, 255, 0.25);
      overflow: hidden;
      max-height: 0;
      transition: max-height 0.3s ease-in-out;
      border: 1px solid #eee;
      padding: 0 15px;
      border-top: none;
    }
    .accordion-wrapper label {
      display: block;
      cursor: pointer;
      color: #777;
      font-size: 1.1em;
      background: #eeeeee;
      padding: 10px 15px;
      border: 1px solid #eee;
      border-bottom: 1px solid transparent;
    }
    .accordion-wrapper input:checked ~ article {
      max-height: 500px; /* 足够容纳内容的合理值,避免 inherit 导致过渡失效 */
    }
    .accordion-wrapper input { display: none; }
  </style><a href="#" data-id="1" class="button">Read more title 1</a>
<a href="#" data-id="2" class="button">Read more title 2</a>

<div class="accordion-wrapper">
  <div>
    <input id="1" name="accordion" type="checkbox"><label for="1">Title 1</label>
    <article><p>Content 1 — Lorem ipsum dolor sit amet.</p>
    </article>
</div>
  <div>
    <input id="2" name="accordion" type="checkbox"><label for="2">Title 2</label>
    <article><p>Content 2 — Consectetur adipiscing elit.</p>
    </article>
</div>
</div>

<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script><script>
  // 点击链接:激活对应面板
  $("a.button").on("click", function(e) {
    e.preventDefault();
    const id = $(this).data('id');
    // 可选:关闭其他面板(单选模式)
    $(".accordion-wrapper input").prop('checked', false);
    $(`#` + id).prop('checked', true);
  });

  // 点击标题:自然触发 checkbox 切换(无需额外 JS)
  // (CSS :checked 已自动处理 article 显隐)
</script>

关键总结

  • 状态驱动 UI:手风琴的开闭本质是 checkbox 的 checked 状态变化,CSS 通过 :checked ~ article 响应,JS 应只负责可靠地更新该状态。
  • .prop() 是金标准:对 checked、disabled、selected 等布尔状态,必须使用 .prop(),而非 .attr()。
  • 避免内联样式干扰:删除所有手动设置 max-height 的 JS 代码,让 CSS 过渡完全接管动画。
  • 增强健壮性:通过 data-id 解耦链接与面板,支持任意数量 accordion 项,且易于维护。

遵循以上原则,即可实现稳定、可预测、符合现代前端实践的手风琴联动控制。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2573

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

1678

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

1415

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

1344

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

3687

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

1391

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

1150

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

1080

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

1011

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
jQuery官方API文档
jQuery官方API文档

共0课时 | 0人学习

jQuery 教程
jQuery 教程

共42课时 | 14.1万人学习

HTML+CSS基础与实战
HTML+CSS基础与实战

共132课时 | 16.5万人学习