直接用 css + 原生 javascript 实现最近活动面板即可,无需 jquery 或 vue;核心是用 max-height 过渡替代 display: none 实现平滑展开收起,并通过事件委托与 data-active 状态控制手风琴行为,兼顾性能、兼容性与移动端体验。

直接用 CSS + 原生 JavaScript 就能做,不需要框架,关键在 max-height 过渡和事件委托控制展开逻辑。
为什么不用 jQuery 或 Vue 实现最近活动面板
多数 CMS 或轻量后台只要展示 5–10 条近期活动(如“4月17日:系统维护完成”),加载 jQuery 或整套 Vue 显得冗余。原生方案体积小、启动快、兼容性好(IE11+ 都支持 addEventListener 和 classList)。
- jQuery 会额外增加 ~30KB HTTP 请求,且现代 DOM 操作已足够简洁
- Vue/React 在纯静态展示场景下无状态管理需求,反而增加调试复杂度
- 若后续要加搜索或分页,再引入轻量库(如 Alpine.js)更合理
max-height 动画替代 display: none 的真实原因
display: none 无法触发 CSS 过渡动画,而 max-height 是唯一能平滑收起/展开内容的可靠属性(height: auto 不支持过渡)。常见错误是设 max-height: 0 → max-height: 500px,但硬编码 500px 容易截断长内容。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 推荐写法:
max-height: 0→max-height: 60vh(视口高度 60%,兼顾安全与伸缩性) - 必须配合
overflow: hidden,否则内容会溢出 - 过渡时间建议
0.25s ease-in-out,太快不自然,太慢显卡顿
点击切换时如何避免多个面板同时展开
默认手风琴(accordion)行为要求:点一个,其他自动收起。关键不是靠 for 循环遍历所有 .accordion-content,而是用事件委托 + 状态标记,减少重复 DOM 查询。
- 给每个
.accordion-item加data-active="false"初始属性 - 点击时先查当前是否已激活:
if (item.dataset.active === "true") { ... } else { ... } - 收起全部再展开目标项,比逐个判断更稳定(尤其动态增删项时)
document.querySelectorAll('.accordion-header').forEach(header => {
header.addEventListener('click', () => {
const item = header.closest('.accordion-item');
const content = item.querySelector('.accordion-content');
// 收起所有
document.querySelectorAll('.accordion-content').forEach(c => {
c.style.maxHeight = '0';
c.closest('.accordion-item').dataset.active = 'false';
});
// 展开当前
if (content.style.maxHeight === '0px') {
content.style.maxHeight = '60vh';
item.dataset.active = 'true';
}
});
});
移动端点击区域太小?补足 touch-action 和点击延迟
在 iOS Safari 和部分安卓浏览器中,click 事件有约 300ms 延迟,且小按钮容易误触。不要只加 padding,要从交互层修复。
- 给
.accordion-header加style="touch-action: manipulation;",禁用双击缩放,加速响应 - 确保点击区域 ≥ 44×44px(iOS 最小可点击尺寸),可用
min-height: 44px+padding保证 - 避免用
div当触发器——改用<button type="button"></button>,天然支持空格/回车触发,无障碍友好
最易被忽略的是内容高度突变导致页面跳动:当多个 .accordion-content 同时展开,max-height: 60vh 可能撑满整个屏幕,把底部按钮顶出可视区。上线前务必在真机上滚动测试一次展开/收起组合操作。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










