
本文详解如何使用 jquery 为树形菜单(treeview)添加平滑的展开/收起动画、点击延迟响应及加载提示图标,提升用户交互体验。
在构建可折叠的树形导航菜单时,生硬的即时显示/隐藏会降低用户体验。通过引入 css 过渡或 jquery 动画方法(如 slideToggle),配合视觉反馈(如加载图标),可显著增强界面的专业性与响应感。
✅ 核心实现方案
原插件中使用的是 .toggle(),它仅做显隐切换,无过渡效果。我们将其替换为更自然的 .slideToggle(duration),并加入加载状态模拟:
branch.on('click', function (e) { if (this === e.target) { var icon = $(this).children('i:first'); icon.toggleClass(openedClass + " " + closedClass); // 插入加载提示 $(this).append(' Loading...'); // 延迟 300ms 后执行动画,并移除加载提示 setTimeout(() => { $(this).find('.loading').remove(); $(this).children().children().slideToggle(300); }, 300); } });
? 说明:fa-spin 是 Font Awesome 提供的旋转动画类,确保图标持续转动;setTimeout 模拟“异步加载”延迟,实际项目中可替换为真实 ajax 请求逻辑。
?️ 完整增强版插件代码(含样式优化)
将以下代码整合进您的 js 文件中,即可直接启用带动画与加载态的 Treeview:
$.fn.extend({ treed: function (o) { var openedClass = 'fa-minus-circle'; var closedClass = 'fa-plus-circle'; if (typeof o !== 'undefined') { if (typeof o.openedClass !== 'undefined') openedClass = o.openedClass; if (typeof o.closedClass !== 'undefined') closedClass = o.closedClass; } var tree = $(this).addClass('tree'); tree.find('li').has('ul').each(function () { var branch = $(this); branch.prepend(``); branch.addClass('branch'); branch.on('click', function (e) { if (this === e.target) { var icon = $(this).children('i:first'); icon.toggleClass(openedClass + ' ' + closedClass); // 显示加载提示 $(this).append(' Loading...'); // 延迟后执行滑动动画 setTimeout(() => { $(this).find('.loading').remove(); $(this).children().children().slideToggle(300); }, 300); } }); // 初始隐藏子菜单 branch.children().children().hide(); }); // 支持点击指示器图标触发 tree.find('.branch .indicator').on('click', function () { $(this).closest('li').click(); }); // 支持点击链接或按钮触发 tree.find('.branch > a, .branch > button').on('click', function (e) { $(this).closest('li').click(); e.preventDefault(); }); } });
? 必备 CSS 补充样式
为确保加载提示正常显示,请在 CSS 中添加:
.loading { font-style: italic; color: #666; padding: 4px 0; font-size: 0.85em; } .loading .fa-spinner { margin-right: 6px; }
⚠️ 注意事项与最佳实践
- 避免重复插入 loading 元素:当前示例未做防重复判断。生产环境建议先检查是否存在 .loading 再追加,例如:
if (!$(this).find('.loading').length) { $(this).append('...'); } - 动画中断处理:若用户快速连续点击,slideToggle 可能出现队列堆积。可使用 .stop(true, true) 清除动画队列:
$(this).children().children().stop(true, true).slideToggle(300); - 无障碍支持:为 图标添加 aria-hidden=”true”,并用 aria-expanded 属性动态标记节点展开状态,提升屏幕阅读器兼容性。
- 性能优化:深层嵌套树节点较多时,建议对 slideToggle 使用 display: block/none 替代 height 动画(默认行为),或改用 CSS transition: max-height 实现更轻量的纯 CSS 方案。
✅ 初始化调用示例
$('#tree2').treed({ openedClass: 'fa-folder-open', closedClass: 'fa-folder' });
通过以上改造,你的 Treeview 不仅具备视觉层次感与操作反馈,还为后续集成异步数据加载(如懒加载子节点)预留了清晰的扩展接口。动画与状态提示的结合,让交互更可信、更人性化。